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SOFTWARE DEVELOPMENT KIT FOR REAL-TIME 
COMMUNICATION APPLICATIONS AND SYSTEM 

Cross-Reference to Related Applications 

The present application claims the benefit of U.S. Provisional Application 
5 Serial No. 60/398,940, filed July 25, 2002, titled Software Development Kit for 

Real-Time Communication Application and System. 

Field of the Invention 

The present invention relates to a real-time software development kit (SDK) 
10 and, more particularly, a real-time software development kit that is utilized in secure 

instant messaging and enterprise real-time communications software. 

BACKGROUND OF THE INVENTION 

The consumer instant messaging (IM) model, which is well known in 

1 5 consumer environments such as America Online, and the like, does not generally suit 

the needs of businesses. Businesses typically handle many aspects of instant 
communications differently than the consumer instant messaging user. In most 
cases, business users do not want add or subscribe colleagues to "buddy" lists. 
Instead, business users want to see their co-workers automatically in a 

20 comprehensive, yet well organized list of objects. Grouping is left to the end-user 

client on an ad hoc in most consumer IM applications. In the business world, there is 
a need for groupings that follow the sophisticated tree structures of business 
organizations. Typical consumer IM solutions do not provide the level of control 
required by most enterprises, nor do they offer sufficient security controls or 

25 centralized management of groups and profile lists. 

There has recently been developed a real-time routing architecture provides 
the underlying technology building blocks for business instant messaging and 
enterprise real-time communication software. Servers and clients utilize real-time 
routing architecture that provides a secure, two-way, real-time communications 

30 platform that may be used to build a variety of high performance custom 
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applications. Key components in the platform include Hie real-time engine featuring 
intelligent routing, user identification and presence, or status, virtual channels and 
pipes. Pipes support a variety of multi-server topologies, providing massive 
scalability and/or multi-office communications. The scalable presence management 
5 system is capable of managing and displaying real-time status of thousands of users, 

known as presence objects, without creating network bottlenecks with status updates. 

SUMMARY OF THE INVENTION 

Disclosed is a new instant messaging and enterprise real-time communication 
10 software, referred to herein as a real-time software development kit (SDK). The SDK 

of the present invention provides a set of application programming interfaces (APIs) 
that enables developers and business partners, including system integrators, ISVs, 
OEMs, hardware appliance manufacturers and ASPs, to create custom client/server 
and web-based instant messaging (IM) applications based on the real-time routing 
1 5 architecture disclosed herein, which provides a secure, two-way real-time 

communications platform. The SDK disclosed herein meets the needs of 
organizations that have a desire to rapidly develop secure IM applications, with the 
capability of scaling-up in complex enterprise network environments. 

The SDK supports Microsoft Visual Studio and Delphi development toolsets, 
20 with certified languages including Visual Basic .NET, Visual C#, and Delphi. The 

SDK includes COM and ActiveX Objects and Delphi native components, sample 
applications with source code, online documentation and development environment 
set-up. 

The SDK of the present invention provides a fully functional, secure instant 
25 messaging client with an easy to use interface, with a one-way secure instant 

messaging application for emergency notifications and other broadcast applications, 
and a web-based IM interface. These can be readily adapted to internal and 
customer-facing applications such as CRM, ERP, Enterprise Information Portals 
(EEP), web front-ends, line-of-business and legacy applications. 
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The enterprise server as disclosed herein provides the server component for 
the SDK Run-Time Client. The server delivers authentication, security, directory 
service integration, groups, profiles and other central management capabilities to 
custom client applications. The server supports multi-server topologies, multi- 
threading and symmetric multi-processing (SMP), enabling secure IM applications 
for thousands or tens-of-thousands of users. In addition, it provides private routing 
over LAN, WANs, VPNs, NATs, proxies and firewalls. This ''private routing" as 
disclosed herein provides the capability that supports the complex, distributed 
network environments found in most large organizations today. 

The SDK of the present invention extends the real-time routing architecture. 
The SDK provides an extensible, open interface for bidirectional messaging, which 
supports any real-time data communications stream and any data type. The SDK of 
the present invention allows third-party developers to define their own data types. 

Enterprise instant messaging is evolving into a viable business productivity 
tool for companies of all sizes. The core components of presence management, 
secure instant messaging and text chat provide developers utilizing the disclosed 
invention the ability to create custom instant messaging applications. The ability to 
add real-time presence to existing applications is a powerful enhancement. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a block diagram a physical network of clients and servers 
according to the present invention. 

Figure 2 is a block diagram of a real-time routing architecture according to 
the present invention. 

DETAILED DESCRI PTION OF THE PREFERRED EMBODIMENTS 

Referring now to the drawings, and first to Figure 1, a network is designated 
generally by the numeral 11. Network 1 1 includes interconnected real-time routing 
servers 13, which provide a real-time routing engine, and clients 15. According to 
the present invention, servers 13 are connected to each other by virtual pipes. The 
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pipes route, secure and compress data between sub-networks. The pipes provide the 
custom-routing necessary to support communications over virtually any TCP/TP 
connection, as well as VPNs, gateways and firewalls. Users, through clients 15, are 
connected to real-time routing servers 13 by connections. The connections may be 
through LANs, WANs, the Internet, RAS, Dial-up networking, VPNs, Citrix 
Winframe/Metaframe and Windows Terminal Services through gateways, proxies 
and firewalls. Once connected, users immediately appear as real-time presence 
objects in the real-time routing system. Servers 13 track users by the location of 
their status or presence. Servers 13 can relearn routes to users throughout the system 
In the event of physical routing failure. Network 1 1 may be of any topology, such as 
ring, star, mesh or the like. 

To establish communications between distributed users across various 
connections, the real-time routing system establishes virtual channels between 
various users. Users are joined to a channel through the use of a real-time join. All 
subsequent communications directed toward the channel are directed to all joined 
users on the channel. The channel mechanism is efficiently designed to ensure that 
data is not transmitted more than once across any pipe when directed to a channel. 

The logical structure of a system according to the present invention is 
illustrated in Figure 2. The real-time routing engine comprises channels, pipes and 
presence, described with reference to Figure 1. Additionally, the real-time routing 
engine comprises security and encryption, directory integration and centralized 
management layered above the channels, pipes and presence. The real-time routing 
engine provides a flexible, secure, manageable, proxy and firewall-friendly real-time 
routing core. 

The security system is designed to support a rich variety of corporate security 
policies, by providing end-to-end encryption of all message traffic. The real-time 
engine uses a combination of security protocols. RC4 may be used as a default. 
However, in addition to RC4, the real-time engine may use DES, triple-DES (128 
bits), AES (256 bits) and RSA (up to 512 bits). Additionally, RSA signing, 
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certificates and authentication may be available. These protocols provide a wide 
variety of key-length, performance trade-offs and corporate security options. 

Layered under the security streaming is a compression layer. The 
compression layer uses a compression format, such as zlib compression described in 
5 RFC 1950-1952, on pipes and connections, which achieves up to 4:1 compression. 

As will be recognized by those skilled in the art, other compression formats may by 
utilized. 

The low-level design code at the server level preferably takes advantage of 
symmetrical multi-processing (SMP). Each virtual user runs on a separate thread, 

1 0 and when available, these threads are distributed across multiple CPUs within a 

server. SMP can be useful in the case of large population security alert users. In 
such a scenario, it is more economical support a large population on one or several 
servers when there is little traffic. However, when an urgent message is distributed, 
SMP provides a tremendous performance boost, distributing hundreds of messages 

1 5 per second, per CPU. 

Layered above the real-time routing engine is the component architecture, 
which comprises the ESDK and the EConferencing SDK, which will be described in 
detail hereinafter. The ESDK and EConferencing SDK enable enterprise instant 
messaging, extranet web conferencing, and voice and video conferencing. 

20 The ESDK provides a rich set of tools for creating comprehensive real-time 

communications applications such as instant messaging, chat and presence programs. 
It is designed to operate in most newer development environments such as those 
created by Borland and Microsoft. The ESDK is adapted to provide a presence 
object. The properties, methods and events of the ESDK of the present invention art 

25 disclosed as follows. 

PROPERTIES 
PublicKev 

I PublicKev"Hxe "TESDK:PubIicKev"} 

30 PublicKey: String; 



5 



WO 2004/012050 




CT/US2003/023331 



The PublicKey holds the current public key of the cheat user. The PublicKey 
is used in conjunction with the PrivateKey for real-time servers that require public 
key encryption for encrypted communications. The server console can enable this 
behavior on a real-time server. Under normal circumstances, the PublicKey and 
5 PrivateKey are automatically created when they are required for encrypted 

communications. 

The process of creating a PublicKey and PrivateKey can be time consuming. 
Subsequent client sessions can reuse the PublicKey and PrivateKey from a prior 
session and avoid the time required to create a new key pair. In the event that the 
10 PublicKey and PrivateKey are required for a client session the 

OnClientCertificateKeys event will be triggered. 

Private Kev 

15 (xe "PrivateKey" llxe "TESDK: PrivateKey"! 

PrivateKey: String; 

The PrivateKey holds the current private key of the client user. The 
PrivateKey is used in conjunction with the PublicKey for real-time servers that 
require public key encryption for encrypted communications. The server console can 
20 enable this behavior on a real-time server. Under normal circumstances, the 

PublicKey and PrivateKey are automatically created when they are required for 
encrypted communications. 

MessageAutoClear 
25 (xe "MessageAutoClear"Uxe "TESDK; MessageAutoClear") 

MessageAutoClear: Boolean; 

The MessageAutoClear property determines how messages are retained and 
handled in memory. By default, MessageAutoClear is set to TRUE and messages are 
not retained in memory once they are sent and messages are not retained in memory 
30 once they are received. When sending a message using the SetMessage method, the 
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message information will be cleared from memory when MessageAutoClear is 
TRUE. Otherwise use the ClearMessage and ClearMessageAll events to clear all 
messages from memory. 

When receiving a message, all message information must be extracted by the 
5 client during the OnMessage event using the yarious GetMessage related methods if 

MessageAutoClear is TRUE. Once the OnMessage event is finished, the resulting 
message is deleted from memory if MessageAutoClear is TRUE. 

MessageCompressThreshold 
10 I ' c Message CompressThreshold»)(xe "TESDK:MessageCompressThreshold") 

MessageCompressThreshold: Integer; 

The MessageCompressThreshold property specifies the compression 
threshold sizes in bytes of a message. The default MessageCompressThreshold is 
250,000 bytes. When constructing messages and using the SetMessageBodyAsRTF 
15 method, if the body exceeds the MessageCompressThreshold it is compressed 

automatically. Compression increases the overall message creation time but can 
significantly reduce the size of messages with embedded graphics. 

CommandAutoClear 
20 fxe "CommandAutoClear")lxe "TESDK:CommandAutoClear") 

CommandAutoClear: Boolean; 

The CommandAutoClear property determines how commands are retained 
and handled in memory. By default, CommandAutoClear is set to TRUE and 
commands are not retained in memory once they are sent and commands are not 

25 retained in memory once they are received. When sending a command using the 

SetCommand method, the command information will be cleared from memory when 
CommandAutoClear is TRUE. Otherwise use the ClearCommand and 
ClearCommandAll events to clear all commands from memory. 

When receiving a command, all command information must be extracted by 

30 the client during the OnCommand event using the various GetCommand related 
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methods if CommandAutoClear is TRUE. Once the OnCommand event is complete, 
the command related information is cleared from memory. To change this behavior, 
set CommandAutoClear to FALSE. 

5 Connected 

fxe "Connected»)ixe "TESDK; Connected") 
property Connected: Boolean; 

The Connected property is used to determine if the client has established a 
socket connection with the real-time server. A value of TRUE indicates a socket 

10 connection is established. A value of FALSE indicates the socket is not connected. 

The Connected property can be used to determine if a real-time client connection is 
still connected. The OnClientConnected event is used to perform initial 
communications once a connection is established such as receiving stored messages 
and sending and receiving of status information for users. The OnClientConnected 

15 event occurs after the negotiations are completed and the real-time connection is 

approved. See the OnClientConnected event for more details. 

IE 

fxe "IP")fxe "TESDK:IP1 
20 property IP: String; 

The IP property is used to specify the IP address or host name of the real-time 
server. The BP property holds the IP address portion of the address of the real-time 
server for establishing a connection. 
For example, 
25 MyESDK.IP = "127.0.0.1" 

MyESDK. Port = 35000 
MyESDK. Connect 

Port 

30 fxe 'Tort"lfxe "TESDK:Port") 
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property Port: Integer; 

The Port property is used to specify the default port of the real-time server. 
The port is the default port required for clients connecting to the real-time server. 
The default port for the real-time server is TCP port 35000. The default port can be 
5 modified on a real-time server using the server console. 

For example, 

MyESDKJP = "127.0.0.1" 

MyESDK. Port 35000 

MyESDK.Connect 

10 

Account 

Ixe "Account»Uxe "TESDK: Account' >) 

property Account: String; 

The Account property specifies the account name used to logon to the real- 
15 time server. The Account and Password are only required if the real-time server has 

been configured for authentication using the server console. The Account is the name 
of the user to logon to the real-time server. A Password must also be provided to 
connect to the real-time server. If the initial provided Account and Password are 
incorrect or the account and password are not provided, the client will trigger an 
20 OnClientLogon event to request the Account and Password. Once the Account and 

Password are verified, the client will trigger an OnClientUID event to provide the 
user identification to the client based upon the validated Account and Password. 
For example, 

MyESDKJP = "127.0.0.1" 
25 MyESDK.Port 35000 

MyESDK.Account = "Account" 

MyESDK. Password = "Password" 

MyESDK.Connect 

30 Password 
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fxe Password "Uxe "TESDK:Password") 

property Password: String; 

The Password property specifies the password used to logon to the real-time 
server. The Account and Password are only required if the real-time server has been 
5 configured for authentication using the server console. The Password is the password 

of the user to logon to the real-time server. An Account must also be provided to 
connect to the real-time server. If the initial provided Account and Password are 
incorrect or the account and password are not provided, the client will trigger an 
OnClientLogon event to request the Account and Password. Once the Account and 
10 Password are verified, the client will trigger an OnCUentUID event to provide the 

user identification to the client based upon the validated Account and Password. 
For example, 

MyESDK. "127.0.0.1" 

MyESDK. Port 35000 
15 MyESDK-Account = 'Account' 

MyESDK Password = "Password" 

MyESDK.Connect 

UID 

20 Ixe "UID»)(xe "TESDKtUID") 

property UID: String; 

The UID is the user identification value of the client user. A UID uniquely 
identifies the user to the real-time server. Each user must have their own unique UID 
user identification. The UID should be constant for each respective user and persist 

25 between each session they maintain with the real-time server. 

The UID information may be maintained in the client application or 
authentication may be enabled on the real-time server so that the real-time server 
maintains the UID information. To maintain the UID within the client application, 
call CreatelD at least once to generate a UID value and then retain that value in the 

30 client application. The UID must be assigned to the UID property before calling the 
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Connect method. If the real-time server is maintaining the UID, enable user 
authentication in the real-time server console and provide an Account and Password 
when the client connects. Once the account and password are verified by the real- 
time server, a UID will be provided through the OnClientUID event. 

5 

Identity 

!xe "Identitv"Uxe "TESDKtldentitv") 

property Identity: String; 

The Identity is the visible displayed status name that represents the client 
10 user. The Identity is strictly used for display purposes in the status or presence 

directory. 
For example, 

MyESDK.Identity = "John Smith" • 

15 VCL 

{ xe "VCL»)lxe "TESDKtVCL") 

property VCL: Boolean; 

The VCL property is used to indicate the application is being developed in 

Delphi and will be using the VCL during real-time events. The real-time software 
20 development kit uses threads for maximum socket efficiency for events and internal 

processes. Since Delphi requires synchronization of thread activity when threads 

access the VCL, it is necessary to set VCL to TRUE. 

For example, 

MyESDK.VCL = TRUE 
25 Set VCL to TRUE only if using Delphi and only if the Delphi application accesses 

the VCL. Console applications and service handler applications on Delphi typically 

do not access the VCL. Do not set VCL to TRUE on other development platforms as 

it will prevent communications from operating properly. 
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METHODS 
CreateD) 

(xe "CreateID"Uxe "TI^DK:CreateID") 
function CreateDD: String; 
5 The CreateDD method generates a generic ID string that can be used as a user 

identifier, channel identifier, command identifier or message identifier within the 
real-time platform. Under normal circumstances this method does not have to be 
called directly. 
Return Values 

10 If the method succeeds, the return value is an ID string. 

If the method fails, the return value is NULL. 

GetSecuritv 

ixe "GetSecuritv»)lxe "TESDK:GetSecuritv") 

15 function GetSecurity: String; 

The GetSecurity method returns a string that identifies the current encryption 
method that the real-time server is using. Possible results include RC4, RC4+RSA, 
DES+RSA, DES3+RSA, AES+RSA. The security policy is automatically handled by 
the real-time server and is required by all connecting clients. The real-time SDK 

20 handles all the security and encryption work automatically. 

For RSA based security policies, the client will automatically generate the 
PKI public and private keys required to communicate with the server. The process of 
creating keys can take a while, but will insure that each communication session is 
uniquely encrypted. To avoid the time required to generate keys, save the public and 

25 private keys after the first time they are created. Once created, they are retained in 

the PublicKey and PrivateKey properties. The keys can also be manually generated 
using the GetCertificateKeys method. 

When the real-time client requires the public and private keys it will fire the 
OnClientCertificateKeys event. An application can respond by passing the 

30 previously stored keys back to the client in this event. If the application does not 
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reply to the keys in this event, then the real-time client will make new PKI public 
and private keys each time they are required. For more information on using and 
retaining security keys, see the OnClientCertificateKeys event. 
Return Values 

5 If the method succeeds, the return value is a siring representing the security 

method. 

If the method fails, the return value is the string 'Unknown'. 

GetCertificateKevs 
10 (xe "GetCertificateKevs"Uxe "TESDK: GetCertificateKeys" I 

function GetCertificateKeys: Boolean; 

The GetCertificateKeys method generates a public and private key pair that is 
compatible with the real-time server and stores the results in the PublicKey and 
PrivateKey strings. Under normal circumstances it is not necessary to manually 
create these keys. If a real-time server has enforced a security policy that requires 
certificate keys, they will be automatically generated by the real-time SDK on 
demand. Because the key creation time can be time consuming, it is recommended 
the keys be saved the first time they are created. 

When the real-time client requires the public and private keys it will fire the 
OnClientCertificateKeys event. The application can respond by passing the 
previously saved keys back to the client in this event. If the application does not 
reply to the keys in this event, then the real-time client will make new PKI public 
and private keys each time they are required. For more information on using and 
retaining security keys, see the OnClientCertificateKeys event. 
Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 
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CreateChannel 

Ixe "CreateChannel"Hxe <TESDK:CreateChannel"l 

function CreateChannel: String; 

The CreateChannel method creates a new in-memory channel record for real- 

5 time communications. Use CreateChannel to create a custom in-memory channel for 

sending and receiving any custom information using the real-time platform. 
Channels are used within the real-time platform to control where information is 
routed and which users actually receive the information content. It is not necessary to 
use channels to access the presence, status and message features of the real-time 

10 platform. Channels are only used when creating a custom communications solution. 

The real-time servers actually route across geographic boundaries in real-time 
to deliver content. To add users to the communications channel use the 
AddUserToChannel method. As many users may be added to a given channel that 
will participate in the communications. The channel is not actually created on the 

15 real-time server until the SetChannel method is invoked. New users may be added to 

a channel at anytime by subsequent calls to the AddUserToChannel method followed 
by SetChannel. Simply use the CID previously returned by the call to 
CreateChannel. 
Return Values 

20 If the method succeeds, the return value is the CID string. 

If the method fails, the return value is NULL. 

AddUserToChannel 

f xe "AddUserToChannePUxe "TESDK;AddUserToChannel") 

25 procedure AddUserToChannel (CID: String; UID: String); 

The AddUserToChannel method joins a user to a given in-memory channel 
record. In order to have the join be processed by the server, call the SetChannel 
method. To destroy a channel and clear all the users from the channel, call the 
SetChannelLeaveAU method. 
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Parameters 

cm 

A string representing the channel identifier. 
UID 

5 A string representing the user identifier. 

DeleteUserFromChannel 

fxe 'TJeleteUserFromChanneP'Uxe "TESDK:DeleteUserFromChannel) 

procedure DeleteUserFromChannel (CID: String; UID: String); 

10 The DeleteUserFromChannel method removes a user from a given channel 

in-memory channel record. This method is only effective at removing users from an 
in-memory channel record before a call to SetChannel. To destroy a channel and 
clear all the users from the channel on a real-time server, call the 
SetChannelLeaveAU method instead. 

15 Parameters 
CID 

A string representing the channel identifier. 
UID 

A string representing the user identifier. 

20 

SetChannel 

ixe "SetChannel»Hxe "TESDKiSetChannel") 

function SetChannel (CID: String) : Boolean; 

The SetChannel method invokes the in-memory channel and all the users 

25 assigned to the channel with the real-time server. To send information or content to 

the channel, see the CreateCommand and its related methods. Channels are used 
within the real-time platform to control where information is routed and which users 
actually receive the information content. It is not necessary to use channels to access 
the presence, status and message features of the real-time platform. They are only 

30 used when creating a custom communications solution. The real-time servers 
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10 



actually route across geographic boundaries in real-time to deliver the content. To 
add users to the communications in-memory channel use the AddUserToChannel 
method. 
Parameters 
CID 

A string representing the channel. 
Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 



SetChannelLeaveAU 

ixe "SetChannelLeaveAll"Uxe "TESDKrSetChannelLeaveAll") 

function SetChannelLeaveAll(CID: String): Boolean; 

The SetChannelLeaveAU method destroys the channel and removes all users 
15 from the channel with the real-time server. 

Parameters 

CID 

A string representing the channel identifier. 
Return Values 

20 If the method succeeds, the return value is TRUE. 

If the method fails, the return value is FALSE. 

GetChannelCount 

(xe "GetChannelCount"Uxe << TESDK:GetChannelCount") 

25 function GetChannelCount: Integer; 

The GetChannelCount method returns the total number of in-memory 
channel records that have been defined within the real-time client. Once a channel 
has been activated with the real-time server using SetChannel, that in-memory 
channel record may be cleared using either the ClearChannel or ClearChannelAll 

30 methods. 
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Return Values 

If the method succeeds, the return value is an integer channel count. 
If the method fails, the return value is 0. 



5 GetChannelCID 

Ixe "GetChannelCID")(xe "TESDK: GetChannelCID"! 

function GetChannelCED(Index: Integer) : String; 

The GetChannelCID method returns the CID associated with a given in- 
memory channel based upon the in-memory channel index. To determine the total 
10 count of channels in memory, call the GetChannelCount method. Channel indexes 

are relative to zero in memory. To walk the entire channel listing in memory, start at 
zero and go to GetChannelCount minus one. 
Parameters 
Index 

15 An integer representing the in channel index. 

Return Values 

If the method succeeds, the return value is the CID string. 
If the method fails, the return value is NULL. 



20 ClearChannel 

Ixe "ClearChanneP'Hxe "TESDKrClearChannel") 

procedure ClearChannel(CID: String);' 

The ClearChannel method deletes an in-memory channel. 
Parameters 
25 CID 

A string representing the channel identifier. 
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ClearChannelAU 

(xe "ClearChannelAlFUxe 'TOSDK:ClearChanndAlI") 

procedure ClearChannelAU; 

The ClearChannelAU method deletes all in-memory channel records. 

CreateCommand 

Ixe "CreateCommand")lxe << TESDK:CreateCommand"l 

function CreateCommand: String; 

The CreateCommand method creates a new in-memory command record for 
real-time communications. Commands are sequences of data and information that are 
relayed to a channel, routed within the real-time environment and received by the 
real-time client. A channel should already be established using the SetChannel 
method before sending a command using SetCommand. For more information on 
channels, see the SetChannel method. 
Return Values 

If the method succeeds, the return value is the RID string. 

If the method fails, the return value is NULL. 

SetCommand 

Ixe "SetCommand")lxe "TESDK;SetCommand") 

function SetCommand(RID, CID: String): Boolean; 

The SetCommand method sends a custom command to the real-time server. 
If a custom command has been fully constructed and is ready to be sent to the real- 
time server, call this method. Commands are constructed using the 
SetCommandString, SetCommand Integer, SetCommandBoolean, 
SetCommandDateTime and SetCommandStream methods. Commands are sent to 
channels that have been created and already established through the SetChannel 
method. A command must also include a command value to identify it to the real- 
time routing engine of the ESDK. Call the SetCommandCMD method to assign a 
command value. 
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Parameters 

RID 

A string representing the command identification value. 
CID 

5 A string representing the channel identification value. 

Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 



10 SetCommandString 

ixe "SetCommandString"Kxe "TESDK;SetCommandString") 

procedure SetCommandString(RID: String; Prop: Integer; Value: String); 

The SetCommand String method sets a string property of a command. To 
change a command, provide the property and a new value. Constructing a command 
15 involves adding various details to a created command. In order to have the command 

sent to the real-time server, call the SetCommand method. 
For example, 

MyESDK.SetCommandString(RID, 10000, "Hello World") 
The RID represents the command identifier that was obtained by calling the method 
20 CreateCommand. The property value 10000 is a property that is user defined within 

the command. 
Parameters 
RID 

The command identifier of the command. 
25 Prop 

An integer representing the property. 
Value 

A string representing the value assigned to the property. 
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SetCommandlnteger 

{xe "SetCommandInteger")(xe 'HTESDKiSetCommandlnteger") 

procedure SetCommandInteger(RID: String; Prop: Integer; Value: Integer); 

The SetCommand Integer method sets an integer property of a command. To 
change a command, provide the property and a new value, Constructing a command 
involves adding various details to a created command. In order to have the command 
sent to the real-time server, call the SetCommand method. 
For example, 

MyESDK.SetCommandInteger(Rl , 001, 101) 
The RID represents the command identifier that was obtained by calling the method 
CreateCommand. The property value 10001 is a property that is user defined within 
the command. 
Parameters 



The command identifier of the command. 
Prop 

An integer representing the property. 
Value 

An integer representing the value assigned to the property. 
SetCommand Boolean 

Ixe "SetCommandBoo]ean")fxe "TESDKiSetCommandBoolean") 

procedure SetCommandBoolean(RID: String; Prop: Integer; Value: Boolean); 

The SetCommandBoolean method sets a boolean property of a command. To 
change a command, provide the property and a new value. Constructing a command 
involves adding various details to a created command. In order to have the command 
sent to the real-time server, call the SetCommand method. 
For example, 

MyESDK.SetCommandBoolean(RID, 10002, FALSE) 
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The RID represents the command identifier that was obtained by calling the method 
CreateCommand. The property value 10002 is a property that is user defined within 
the command. 
Parameters 
5 RID 

The command identifier of the command. 

Prop 

An integer representing the property. 
Value 

10 A boolean representing the value assigned to the property. 

SetCommandDateTime 

Ixe "SetCommandDateTime"llxe 'TESDK: SetCommandDateTime") 

procedure SetCommandDateTime(RID: String; Prop: Integer; Value: TDateTime); 
15 The SetCommandDateTime method sets a datetime property of a command. 

To change a command, provide the property and a new value. Constructing a 
command involves adding various details to a created command. In order to have the 
command sent to the real-time server, call the SetCommand method. 
For example, 

20 MyESDK.SetCommandDateTime(RID, 1 0003, Now) 

The RID represents the command identifier that was obtained by calling the method 
CreateCommand. The property value 10003 is a property that is user defined within 
the command. 
Parameters 
25 RID 

The command identifier of the command. 
Prop 

An integer representing the property. 
Value 

30 A datetime representing the value assigned to the property. 



21 



WO 2004/012050 




CT7US2003/023331 



SetCommandStream 

f "SetCommandStream"Uxe <4 TESDK:SetCommandStream"l 

procedure SetCommandStream(RID: String; Prop: Integer; Value: 
TMemoryStream); 

5 The SetCommandStream method sets a stream property of a command. To 

change a command, provide the property and a new value. Constructing a command 
involves adding various details to a created command. In order to have the command 
sent to the real-time server, call the SetCommand method. 
For example, 

10 <— MyESDK.SetCommandStream(RID, 10004, MyStream) 

The RID represents the command identifier that was obtained by calling the method 
CreateCommand. The property value 10004 is a property that is user defined within 
the command. 

Streams are designed for compatibility with Borland development 
15 environments. For Microsoft development environments, SetCommandOleVariant 

may be needed instead. 
Parameters 

RID 

The command identifier of the command. 
20 Prop 

An integer representing the property. 
Value 

A stream representing the value assigned to the property. 

25 SetCommandOleVariant 

Ixe "SetCommandQleVariant"){xe "TESDK: SetCommandOle Variant") 

procedure SetCommandOle Variant(RID: String; Prop: Integer; Value: Ole Variant); 

The SetCommandOleVariant method sets an olevariant property of a 
command. To change a command, provide the property and a new value. 



22 



WO 2004/012050 




'CT7US2003/023331 



Constructing a command involves adding various details to a created command. In 
order to have the command sent to the real server, call the SetCommand method. 
For example, 

MyESDK.SetCoinmand01eVariant(RID, 10005, MyOleVariant) 
5 The RID represents the command identifier that was obtained by calling the method 

CreateCommand. The property value 10005 is a property that is user defined within 
the command. 

Parameters 

RID 

1 0 The command identifier of the command. 

Prop 

An integer representing the property. 
Value 

An olevariant representing the value assigned to the property. 

15 

SetCommandCMD 

Ixe "SetCommandCMD"Uxe "TESDK:SetCommandCMD") 

procedure SetCommandCMD(RTD: String; CMD: Integer); 

The SetCommandCMD assigns a command value to a command. Each 
20 command that is user defined must contain a command value. The command value is 

extracted during the OnCommand event using the GetCommandCMD method. The 
command value is user defined by the developer to determine the type of information 
being received. Starting user defined command values at 50000 is recommended. 
For example, 

25 MyESDK.SetCommandCMD(RID, 50000) 

The RID represents the command identifier that was obtained by calling the method 
CreateCommand. The command value 50000 is a user defined value. 

Parameters 

RID 

30 The command identifier of the command. 
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CMD 

An integer representing the command value. 

GetCommandString 
5 f xe "GetCommandString")ixe "TESDK:GetCommandString") 

function GetCommandString(RID: String; Prop: Integer): String; 

The GetCommandString method gets a property string from a received 
command. To retrieve a string from a received command, provide the RID of the 
command record and the property value of the string. 
10 For example, 

MyString==MyESDK.GetCoimnandString(RID 9 10000) 

The property value 10000 represents the user defined string. To determine the 

command value associated with the command identifier, call the GetCommandCMD 

method. 

15 Parameters 

RID 

A, string representing the command identification value. 
Prop 

An integer representing the property value of the string. 

20 Return Values 

If the method succeeds, the return value is the string value of the specified 
property. 

If the method fails, the return value is NULL. 

25 GetCommandlnteger 

(xe "GetCommandInteger»Hxe "TESDK: GetCommandlnteger" 

function GetCommandInteger(RID: String; Prop: Integer) : Integer; 

The GetCommandlnteger method gets a property integer from a received 
command. To retrieve an integer from a received command, provide the RID of the 
30 command record and the property value of the integer. 
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For example, 

MyInteger=MyESDK.GetCommandInteger(RID 5 10001) 
The property value 10001 represents the user defined integer. To determine the 
command value associated with the command identifier, call the GetCommandCMD 
5 method. 

Parameters 

RID 

A string representing the command identification value. 
Prop 

10 An integer representing the property value of the integer. 

Return Values 

If the method succeeds, the return value is the integer value of the specified 
property. 

If the method fails, the return value is 0. 

15 

GetCommandBoolean 

(xe ^GetCommandBoolean^li^TESDKiGetCommandBoolean^l 

function GetCommandBoolean(RID: String; Prop: Integer) : Boolean; 

The GetCommandBoolean method gets a property boolean from a received 
20 command. To retrieve a boolean from a received command, provide the RID of the 

command record and the property value of the boolean. 
For example, 

MyBool=MyESDK.GetCommandBoolean(RID, 1 0002) 

The property value 10002 represents the user defined boolean. To determine the 
25 command value associated with the command identifier, call the GetCommandCMD 

method. 

Parameters 

RID 

A string representing the command identification value. 
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Prop 

An integer representing the property value of the boolean. 
Return Values 

If the method succeeds, the return value is the boolean value of the specified 
property. 

If the method fails, the return value is FALSE. 
GetCommandDateTime 

{xe "GetCommandDateTime"} {xe "TESDK:GetCommandDateTime"} 
function GetCommandDateTime(RID: String; Prop: Integer): TDateTime; 

The GetCommandDateTime method gets a property datetime from a received 
command. To retrieve a datetime from a received command, provide the RID of the 
command record and the property value of the datetime. 
For example, 

MyDateTime=MyESDK.GetCommandDateTime(RID, 1 0003) 

The property value 10003 represents the user defined datetime. To determine the 

command value associated with the command identifier, call the GetCommandCMD 



Parameters 

RID 

A string representing the command identification value. 
Prop 

An integer representing the property value of the datetime. 
Return Values 

If the method succeeds, the return value is the datetime value of the specified 
property. 

If the method fails, the return value is 0. 



method. 
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GetCommandStream 

fxe "GetCommandStreamUxe "TESDK: GetCommandStream") 

function GetCommandStream(RID: String; Prop: Integer) : TMemoryStream; 

The GetCommandStream method gets a property stream from a received 
5 command. To retrieve a stream from a received command, provide the RID of the 

command record and the property value of the stream. 
For example, 

MyStream=MyESDK.GetCoinmandStream(RID, 10004) 
The property value 10004 represents the user defined stream. To determine the 
10 command value associated with the command identifier, call the GetCommandCMD 

method. 

Streams are designed for compatibility with Borland development 
environments. For Microsoft development environments, GetCommandOleVariant 
may be needed instead. 

15 Parameters 

RID 

A string representing the command identification value. 
Prop 

An integer representing the property value of the stream. 

20 Return Values 

If the method succeeds, the return value is the stream value of the specified 
property. 

If the method fails, the return value is NIL. 
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GetCommandOleVariant 

(xe "GetCommandQleVariant»Hxe ( TOSDK: GetCommandOleVariant"! 

function GetCommand01eVariant(RID: String; Prop: Integer): OleVariant; 

The GetCommandOleVariant method gets a property olevariant from a 
5 received command. To retrieve an olevariant from a received command, provide the 

RID of the command record and the property value of the olevariant. 
For example, 

My01eVariantF=MyESDK.GetCommand01eVariant(RID, 10005) 
The property value 10005 represents the user defined olevariant. To determine the 
10 command value associated with the command identifier, call the GetCommandCMD 

method. 

Parameters 

RID 

A string representing the command identification value. 
15 Prop 

An integer representing the property value of the olevariant. 

Return Values 

If the method succeeds, the return value is the olevariant value of the 
specified property. 
20 If the method fails, the return value is NIL. 



GetCommandCount 

Ixe "GetCommandCount"Hxe "TESDKrGetCommandCount") 

function GetCommandCount: Integer; 
25 The GetCommandCount method returns the total number of in-memory 

commands within the real-time client. The real-time client keeps track of received 
and sent commands in memory. Commands are automatically cleared from memory 
if CommandAutoClear is TRUE once the command is received and after the 
OnCommand event or the command is sent using SetCommand. To manually clear 
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in-memory command records, see the ClearCommand and ClearCommandAll 
methods. 

Return Values 

If the method succeeds, the return value is an integer command count. 
5 If the method fails, the return value is 0. 

GetCommandRID 

Ixe "GetCommandRID"Uxe "TESDK:GetCommandRID"l 

function GetCommandRID(Index: Integer) String; 

The GetCommand RID method returns the RID associated with a given in- 
memory command based upon the in- memory command index. To determine the 
total count of commands in memory, call the GetCommandCount method. Command 
indexes are relative to zero in memory. To walk the entire command listing in 
memory, start at zero and go to GetCommandCount minus one. 

Parameters 

Index 

An integer representing the in-memory command index. 

Return Values 

If the method succeeds, the return value is the RID string. 
If the method fails, the return value is NULL. 

GetCommandCMD 

fxe "GetCommandCMD»Uxe "TESDK;GetCommandCMD") 

function GetCommandCMD(RID: String): Integer; 
25 The GetCommandCMD method returns the command value associated with a 

given in-memory command based upon the command identification. 
Parameters 
RID 

A string representing the command identification value. 
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Return Values 

If the method succeeds, the return value is the command value integer. 
If the method fails, the return value is 0. 

ExistCommandProp 

(xe "ExistCommandProp")(xe "TESDK; ExistCommandProp") 

function ExistCommandProp(RID: String; Prop: Integer): Boolean; 

The ExistCommandProp method checks for the existence of a property 
within an in-memory command. 

Parameters 

RID 

A string representing the command identification value. 
Prop 

An integer representing the property value. 

Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 

ExistCommand 

20 Ixe "ExistCommand"Uxe "TESDKrExistCommand") 

function ExistCommand(RID: String): Boolean; 

The ExistCommand method checks for the existence of an in-memory 
command. 

Parameters 

25 RID 

A string representing the command identification value. 

Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 
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ClearCommand 

ixe "ClearCommand"Uxe "TESDKiCIearCommand"! 

procedure ClearCommand (RID: String); 
5 The ClearCommand method clears an in-memory command. 

Parameters 

RID 

A string representing the command identification value. 

10 ClearCommandAll 

Ixe "ClearCommandAir'Kxe "TESDK:ClearCommandAll") 

procedure ClearCommandAll; 

The ClearCommandAll method clears all in-memory commands. 

15 SetStatus 

ixe "SetStatus"Uxe "TESDK:SetStatus") 

function SetStatus: Boolean; 

The SetStatus method announces the client's personal in-memory status to 

the real-time server. All status values assigned are automatically sent to the server. 
20 To assign values to in-memory status, see SetStatusString, SetStatusInteger, 

SetStatusBoolean and SetStatusDateTime. 

Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 

25 

SetStatusMode 

(xe "SetStatusMode"Uxe "TESDKrSetStatusMode") 

function SetStatusMode(Mode: Integer) Boolean; 

The SetStatusMode changes the status operating mode of the real-time client. 
30 The real-time client supports two modes of operation for how status information is 
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received from other users. By default the real-time client operates in full mode 
(T_ST ATUS_FULL) . In full mode, all status information for all users within the 
real-time communications network is received by the real-time client through the 
OnStatus event automatically. It is not necessary to use the GetStatusRequest 

5 method. This is limited in an enterprise real-time environment through the use of 

profiles that are created with the server console on the real-time server. By 
implementing full status mode, an enterprise product is essentially created where the 
majority of user and group management will occur on the real-time server through 
the real-time server's management console. 

10 The other operating mode is known as partial mode 

(T_STATUS_PARTIAL). In partial mode, only status information is received for 
users requested using the GetStatusRequest method. By implementing partial status 
mode an enterprise product is essentially created that operates in a subscriber model 
like most consumer IM products. 

15 For example, 

MyESDK.SetStatusMode(l) 

The status mode 1 (T_MODEJPAL) represents the partial status mode value. For a 
listing of all property values, see Status Constants. 

Once status is requested for a given user in partial status mode, or if using 
20 full status mode, all subsequent status changes for that user will be received through 

the OnStatus event. 

Parameters 

Mode 

A integer representing the status operating mode. 

25 Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 
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SetStatusString 

fxe "SetStatusString"Uxe "TESDK:SetStatusString") 

procedure SetStatusString(Prop: Integer; Value: String); 

The SetStatusString method sets a property string in personal in-memory 
5 status. To change in-memory status, provide the property and a new value. In order 

to have status processed by the real-time server after making any changes, call the 
SetStatus method. 
For example, 

MyESDK.SetStatusString(100, "Online") 
10 MyESDK. SetStatus 

The property value 100 (T_STATUS_MSG) represents the status presence message 
that is displayed in the directory next to the user's identity. For a listing of all 
property values, see Status constants. To create extensible custom status properties, 
see creating a custom status property. 

15 Parameters 

Prop 

A integer representing the property. 
Value 

A string representing the value assigned to the property. 

20 

SetStatusInteger 

fxe "SetStatusInteger")! xe "TESDK:SetStatusInteger") 

procedure SetStatusInteger(Prop: Integer; Value: Integer); 

The SetStatusInteger method sets a property string in personal in-memory 
25 status. To change in-memory status, provide the property and a new value. In order 

to have status processed by the real-time server after making any changes, call the 
SetStatus method. 
For example, 

MyESDK. SetStatusInteger( 101, 1) 
30 MyESDK.SetStatus 
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The property value 101 (T_STATUS_STI) represents the status presence image icon 
that is displayed in the directory next to the user's identity. The value 1 (STA_ON) 
tells the client to use the green, online user icon. For a complete listing of all 
property values, see Status constants. To create extensible custom status properties, 
5 see creating a custom status property. 

Parameters 

Prop 

A integer representing the property. 
Value 

10 An integer representing the value assigned to the property. 



SetStatusBoolean 

Jxe "SetStatusBoolean")fxe "TESDKiSetStatusBoolean") 

procedure SetStatusBoolean(Prop: Integer; Value: Boolean); 

The SetStatusBoolean method sets a property boolean in personal in-memory 
status. To change in-memory status, provide the property and a new value. In order 
to have status processed by the real-time server after making any changes, call the 
SetStatus method. For a listing property values, see Status constants. To create 
extensible custom status properties, see creating a custom status property. 

Parameters 

Prop 

A integer representing the property. 
Value 

A boolean representing the value assigned to the property. 
SetStatusPateTime 

Ixe "SetStatusDateTime"Hxe "TESDKtSetStatusDateTime") 

procedure SetStatusDateTime(Prop: Integer; Value: TDateTime); 

The SetStatusDateTime method sets a property datetime in personal in- 
30 memory status. To change in-memory status, provide the property and a new value. 
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In order to have status processed by the real-time server after making any changes, 
call the SetStatus method. 
For example, 

MyESDK.SetStatusDateTime(l 10, Now) 
5 MyESDK.SetStatus 

The property value 110 (TSTATUSJTIME) represents the status presence current 
time that could be displayed in the directory next to the user's identity. For a listing 
property values, see status constants, below. To create extensible custom status 
properties, see creating a custom status property. 

10 Parameters 

Prop 

A integer representing the property. 
Value 

A datetime representing the value assigned to the property. 

15 

GetStatusRequestAU 

{xe "GetStatusRequestAlPixe "TESDK: GetStatusRequestAU"! 

function GetStatusRequestAU: Boolean; 

The GetStatusRequestAU method requests all status information for all users 

20 from the real-time server. To obtain a complete listing of the status of all users from 

the real-time server use this method. The status information is received in the 
OnStatus event. A call to GetStatusRequestAU only provides a listing of users with 
their current status and does not imply tracking status changes for these users. In 
order to track the status changes of users, either use full status mode with the 

25 SetStatusMode method or request status tracking by using the GetStatusRequest 

method. The status information returned by this method is limited by any profile 
restrictions imposed through the real-time server. 

Return Values 

If the method succeeds, the return value is TRUE. 
30 If the method fails, the return value is FALSE. 
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GetStatusReauestOuerv 

(xe "GetStatusRequestOuerv"Uxe ''TESPK: GetStatusRequestQuery" 

function GetStatusRequestQuery (Query: String): Boolean; 
5 The GetStatusRequestQuery method requests status information for partially 

matching users from the real-time server. To obtain a listing of the status of all users 
who partially match the query parameter, use this method. The status information is 
received in the OnStatus event. A call to GetStatusRequestQuery only provides a 
listing of users with their current status and does not imply that the client will be 
10 tracking status changes for these users. In order to track the status changes of users, 

either use full status mode with the SetStatusMode method or request status tracking 
by using the GetStatusRequest method. The status information returned by this 
method is limited by any profile restrictions imposed through the real-time server. 

Parameters * 

15 Query 

A search string representing a partial identity. 

Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 

20 

GetStatusRequest 

(xe "GetStatusRequest»Hxe "TESDK:GetStatusRequest"l 
function GetStatusRequest(UID: String) : Boolean; 

The GetStatusRequest method requests status information and tracking for 

25 the specified UID from the real-time server. A call to GetStatusRequest will 

immediately request the current status of the requested UID. Additionally, any status 
changes that happen for the given UID will automatically be received. All of these 
status changes occur through the use of the OnStatus event. It is only necessary to 
use this method in partial status mode. See SetStatusMode for more details on 

30 changing the status operating mode. 
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Parameters 

UJD 

A string representing the user identification. 
Return Values 

5 If the method succeeds, the return value is TRUE. 

If the method fails, the return value is FALSE. 

GetStatusCount 

Ixe "GetStatusCounf'Uxe "TESDK:GetStatus Count* ») 

10 function GetStatusCount: Integer; 

The GetStatusCount method returns the total number of in-memory status 
records that have been received within the real-time client. The real-time client keeps 
track of the current status information for users in memory provided that either using 
full status operating mode is being used or status tracking using GetStatusRequest in 

1 5 partial status operating mode has been requested. For more information on changing 

the status operating mode see SetStatusMode. To clear all in-memory status records, 
see the ClearStatusAll method. 

Return Values 

If the method succeeds, the return value is an integer status count. 
20 If the method fails, the return value is 0. 

GetStatusUID 

Ixe "GetStatusUID")(xe "TESDK:GetStatusUID") 

function GetStatusUID(Index: integer) : String; 
25 The GetStatusUID method returns the UID associated with a given in- 

memory status based upon the in-memory status index. To determine the total count 
of statuses in memory, call the GetStatusCount method. Status indexes are relative to 
zero in memory. To walk the entire status listing in memory, start at zero and go to 
GetStatusCount minus one. 
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Parameters 

Index 

An integer representing the in-memory status index. 
Return Values 

5 If the method succeeds, the return value is the UID string. 

If the method fails, the return value is NULL. 

GetStatusString 

f xe "GetStatusString"Uxe "TESDK: GetStatusString"! 

10 function GetStatusString(UID: String; Prop: Integer) : String; 

The GetStatusString method gets a property string from an in-memory status 
record. To retrieve a string from an in-memory status record, provide the UID of the 
status record and the property value of the string. 
For example, 

15 Identity==MyESDK.GetStatusString(UID, 103) 

The property value 103 (T_STATUS_IDENTITY) represents the identity or 
displayed name in the directory for the given UID. For a listing property values, see 
Status constants. To create extensible custom status properties, see creating a custom 
status property. 

20 Parameters 

UID 

A string representing the user identification value. 
Prop 

An integer representing the property value of the string. 

25 Return Values 

If the method succeeds, the return value is the string value of the specified 
property. 

If the method fails, the return value is NULL. 
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GetStatusInteger 

fxe "GetStatusInteger"Hxe "TESDK:GetStatusInteger"l 

function GetStatusInteger (UID: String; Prop: Integer) : Integer; 

The GetStatusInteger method gets a property integer from an in-memory 
5 status record. To retrieve an integer from an in-memory status record, provide the 

UID of the status record and the property value of the integer. 
For example, 

State=MyESDK. GetStatusInteger(U ED, 101) 

The property value 101 (TJSTATUS_STATE) represents the state in the directory 
10 for the given UID. The state is the type of icon that is displayed next to a given name 

for their current status state (ex: Do not disturb). For a listing property values, see 
Status constants. To create custom status properties, see How to Creating a Custom 
Status Property. 

Parameters 

15 UID 

A string representing the user identification value. 
Prop 

An integer representing the property value of the string. 
Return Values 

20 If the method succeeds, the return value is the integer value of the specified 

property. 

If the method fails, the return value is 0. 



GetStatusBoolean 
25 Ixe "GetStatusBoolean")ixe "TESDK:GetStatusBoolean") 

function GetStatusBoolean(UID: String; Prop: Integer) : Boolean; 

The GetStatusBoolean method gets a property boolean from an in-memory 
status record. To retrieve a boolean from an in-memory status record, provide the 
UID of the status record and the property value of the boolean. For a listing property 
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values, see Status constants, below. To create extensible custom status properties, see 
How to Creating a Custom Status Property. 

Parameters 

UID 

5 A string representing the user identification value. 

Prop 

An integer representing the property value of the boolean. 
Return Values 

_ If the method succeeds, the return value is the boolean value of the specified 
10 property. 

If the method fails, the return value is FALSE. 

GetStatusDateTime 

(xe "GetStatusDateTime")fxe "TESDK: GetStatusDateTime") 

15 function GetStatusDateTime (UID: String; Prop: Integer): TDateTime; 

The GetStatusDateTime method gets a property datetime from an in-memory 
status record. To retrieve a datetime from an in-memory status record, provide the 
UID of the status record and the property value of the datetime. 
For example, 

20 Time=MyESDK.GetStatusDateTime(UID, 1 1 0) 

The property value 110 (TJSTATUSJTIME) represents the date and time in the 
directory for the given UID. For a listing property values, see Status constants. To 
create custom status properties, see creating a custom status property. 

Parameters 

25 UID 

A string representing the user identification value. 
Prop 

An integer representing the property value of the datetime. 
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Return Values 

If the method succeeds, the return value is the datetime value of the specified 
property. 

If the method fails, the return value is 0. 
GetStatusGroupCount 

fxe "GetStatusGroupCount"Hxe "TESDK: GetStatusGroupCount" 

The GetStatusGroupCount method returns the total number of in-memory 
groups associated with the specified in-memory user. To extract the group names 
associated with any particular index, see GetStatusGroup. 

Parameters 

UID 

A string representing the user identification value. 
Return Values 

If the method succeeds, the return value is an integer group count for the 
respective user. 

If the method fails, the return value is 0. 



10 



15 



GetStatusGroup 
20 fxe "GetStatusGroup"l(xe "TESDK: GetStatusGroup") 

The GetStatusGroup method returns the group name associated with a given 
in-memory user based upon the group index. To determine the total count of groups 
related to a user in memory, call the GetStatusGroupCount method. Indexes are 
relative to zero in memory. To check the entire recipient list in memory, start at zero 
25 and go to GetStatusGroupCount minus one. 

Parameters 

UID 

A string representing the user identification value. 
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Index 

An integer representing the in-memory group index. 
Return Values 

If the method succeeds, the return value is a string representing the group 

5 name. 

If the method fails, the return value is NULL. 
ExistStatusProp 

(xe "ExistStatusProp"Uxe "TESDKrExistStatusProp") 
10 function ExistStatusProp(UID: String; Prop: Integer): Boolean; 

The ExistStatusProp method checks for the existence of a property within an 
in-memory status record. This method can be used to check for the existence of a 
property in an in-memory status record. The method can be used for both common 
status properties and custom^tatus properties. For a listing property values, see 
15 Status constants. To create custom status properties, see creating a custom status 

property. 

Parameters 

UID 

A string representing the user identification value. 
20 Prop 

An integer representing the property value. 

Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 

25 

ExistStatus 

{xe "ExistStatus"Hxe "TESDK:ExistStatus") 
function ExistStatus(UID: String) : Boolean; 
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The ExistStatus method checks for the existence of a given in-memory user 
status record. 
Parameters 

UID 

5 A string representing the user identification value. 

* 

Return Values 

If the method succeeds, the return value is TRUE 
If the method fails, the return value is FALSE. 

10 ClearStatusAll 

f xe "ClearStatusAU»Hxe "TESDK:ClearStatusAll") 

procedure ClearStatusAll; 

The ClearStatusAll method clears all in-memory status records. The status 
records are only removed from the local in-memory and can be refreshed at anytime 
15 by calling GetStatusRequestAU, GetStatusRequestQuery or GetStatusRequest. 

ClearStatusGroups 

Ixe "ClearStatusGroups")(xe "TESPK: ClearStatusGroups"! 

procedure ClearStatusGroups; 
20 The ClearStatusGroups method clears all groups from personal in-memory 

status. 

ClearStatusProperties 

ixe "ClearStatusProperties"l(xe "TESDK:ClearStatusProperties" 

25 procedure ClearStatusProperties; 

The ClearStatusProperties method clears all custom properties from personal 
in-memory status. 
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CreateMessage 

fxe "CreateMessage"){xe "TESDK: CreateMessage"! 

function CreateMessage: String; 

The CreateMessage method creates a new in-memory message record. Use 
5 CreateMessage to create a custom in-memory message for sending messages to the 

real-time server. When constructing a message to be sent, start by creating a message 

in-memory. The CreateMessage method returns a string which represents the MID of 

the created message. 

For example, 
1 0 MID=MyESDK.CreateMessage 

For more information on sending messages, see How to Send a message. 

Return Values 

If the method succeeds, the return value is the MID string. 
If the method fails, the return value is NULL. 

15 

SetMessage 

Ixe "SetMessage"U << TESDK:SetMessage"l 
function SetMessage(MID: String): Boolean; 

The SetMessage sends an in-memory message to the real-time server. If a 
20 message has been fully constructed and is ready to be sent to the real-time server, 

call this method. For more information on sending messages, see How to Send a 
Message. 

Parameters 

MID 

25 A string representing the message identification value. 

Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 



44 



WO 2004/012050 




'CT/US2003/023331 



SetMessageString 

fxe "SetMessageString")lxe "TESDK:SetMessageString") 

procedure SetMessageString(MID: String; Prop: Integer; Value: String); 

The SetMessageString method sets an in-memory property string. To change 
5 an in-memory message, provide the property and a new value. Constructing a 

message involves adding various details to a created message. For more information 
on sending messages, see How To Send a Message. In order to have the message 
sent to the real-time server, call the SetMessage method. 
For example, 

10 MyESDK.SetMessageString(MID, 105, "My Subject") 

The MID represents the message identifier that was obtained by calling the method 
CreateMessage. The property value 105 (T_MESSAGE_SUBJECT) represents the 
subject of the message. For a listing property values, see Message constants. To 
create extensible custom message properties, see How to Create a Custom Message 

15 Property. 

Parameters 

MID 

The message identifier of the message. 
Prop 

20 A integer representing the property. 

Value 

A string representing the value assigned to the property. 



SetMessagelnteger 
25 ixe "SetMessageInteger"Uxe "TESDKtSetMessagelnteger") 

procedure SetMessageInteger(MID: String; Prop: Integer; Value: Integer); 

The SetMessagelnteger method sets an in-memory property integer. To 
change an in-memory message, provide the property and a new value. Constructing a 
message involves adding various details to a created message. For more information 
30 on sending messages, see How To Send a Message. In order to have the message 
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sent to the real-time server, call the SetMessage method. For a listing property 
values, see Message constants. To create extensible custom message properties, see 
How to Create a Custom Message Property. 

Parameters 

5 MID 

The message identifier of the message. 
Prop 

A integer representing the property. 
Value 

10 An integer representing the value assigned to the property. 

SetMessageBooIean 

(xe "SetMessageBoolean»Uxe "TESDKzSetMessageBoolean") 

procedure SetMessageBoolean(MID: String; Prop: Integer; Value: Boolean); 

15 The SetMessageBooIean sets an in-memory property boolean. To change an 

in-memory message, provide the property and a new value. Constructing a message 
involves adding various details to a created message. For more information on 
sending messages, see How to Send a Message. In order to have the message sent to 
the real-time server, call the SetMessage method. For a listing property values, see 

20 Message constants. To create extensible custom message properties, see How to 

Create a Custom Message Property. 

Parameters 

MID 

The message identifier of the message. 
25 Prop 

A integer representing the property. 
Value 

A boolean representing the value assigned to the property. 
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SetMessageDateTime 

{xe "SetMessagePateTime"Hxe "TESPK:SetMessagePateTime"l 

procedure SetMessageDateTime(MID: String; Prop: Integer; Value: TDateTime); 

The SetMessageDateTime method sets an in-memory property datetime. To 
5 change an in-memory message, provide the property and a new value. Constructing a 

message involves adding various details to a created message. For more information 
on sending messages, see How To Send a Message. In order to have the message 
sent to the real-time server, call the SetMessage method. 
For example, 

10 MyESDK.SetMessageDateTime(MID,l 06,Now) 

The MID represents the message identifier that was obtained by calling the method 
CreateMessage. The property value 106 (TJVLESSAGE_SENT) represents the date 
and time the message was sent. For a listing property values, see Message constants. 
To create extensible custom message properties, see How to Create a Custom 

15 Message Property. 

Parameters 

MID 

The message identifier of the message. 
Prop 

20 A integer representing the property. 

Value 

A datetime representing the value assigned to the property. 



SetMessageStream 
25 ixe "SetMessageStream")(xe "TESDKrSetMessageStream") 

procedure SetMessageStream(MID: String; Prop: Integer; Value: TMemoryStream); 

The SetMessageStream method sets an in-memory property stream. To 
change an in-memory message, provide the property and a new value. Constructing a 
message involves adding various details to a created message. For more information 
30 on sending messages, see How to Send a Message. In order to have the message sent 
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to the real-time server, call the SetMessage method. Streams are designed for 
compatibility with Borland development environments. For Microsoft development 
environments, SetMessageOleVariant may be needed instead. For a listing property 
values, see Message constants. To create extensible custom message properties, see 
5 How to Create a Custom Message Property. 

Parameters 

MID 

The message identifier of the message. 
Prop 

10 A integer representing the property. 

Value 

A stream representing the value assigned to the property. 

SetMessageOleVariant 0 
15 fxe "SetMessageQleVariant"llxe "TESDK: SetMessageOleVariant") 

procedure SetMessage01eVariant(MID: String; Prop: Integer; Value: OleVariant); 
The SetMessageOleVariant method sets an in-memory property olevariant. 

To change an in-memory message, provide the property and a new value. 

Constructing a message involves adding various details to a created message. For 
20 more information on sending messages, see How to Send a Message. In order to 

have the message sent to the real-time server, call the SetMessage method. 

Ole Variants are designed for compatibility with Microsoft development 

environments. For Borland development environments, choose to use 

SetMessageStream instead. For a listing property values, see Message constants. To 
25 create extensible custom message properties, see How to Create a Custom Message 

Property. 

Parameters 

MID 

The message identifier of the message. 
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Prop 

A integer representing the property. 
Value 

An olevariant representing the value assigned to the property. 

5 

SetMessageBodyAsRTF 

ixe "SetMessageBodvAsRTF"Uxe "TESDK: SetMessageBodyAsRTF') 
procedure SetMessageBodyAsRTF(MID: String; Value: String); 

The SetMessageBodyAsRTF method assigns rich text formatted content to a 

10 message body. This method takes rich text with fonts, colors and graphics, embedded 

images and objects and applies the content as the body of the message. To use this 
method, simply transfer the content of a RichEdit control or component to a string. 
The string can then be directly assigned to the SetMessageBodyAsRTF method. 

Constructing a message involves adding various details to a created message. 

15 For more information on sending messages, see How To Send a Message. In order to 

have message sent to the real-time server, call the SetMessage method. 

Parameters 

MID 

The message identifier of the message. 
20 Value 

A string comprised of rich text formatted content. 

SetMessageBodvAsText 

f xe "SetMessageBodyAsText* 'Ifxe "TESDKiSetMessageBodvAsText 

25 procedure SetMessageBodyAsText (MID: String; Value: String) ; 

The SetMessageBodyAsText method assigns plain text content to a message 
body. This method takes plain text, converts it to simple rich text and applies the 
content as the body of the message. To apply carriage returns in the body of the text, 
include the characters LF (10) and CR (13) together within the string. 
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Constructing a message involves adding various details to a created message. 
For more information on sending messages, see How to Send a Message. In order to 
have the message sent to the real-time server, call the SetMessage method. 

Parameters 

MID 

The message identifier of the message. 
Value 

A string comprised of rich text formatted content. 
SetMessageRecipient 

Ixe "SetMessageRecipient"Uxe "TESDK:SetMessageRecipient") 
procedure SetMessageRecipient (MID: String; Value: String; UID: String); 

The SetMessageRecipient method adds a recipient to a message. This method 
is used to add a recipient to the recipients list for a message. In order to add a 
recipient, supply a descriptive name and UID. 
For example, 

MyESDK.SetMessageRecipient(Ml D, Smith", UID) 

Subsequent calls to SetMessageRecipient will add more users to the recipient list A 
typical recipient uses the Identity as the descriptive name associated with a single 
UID. However, the SetMessageRecipient method supports the ability to associate 
multiple different UIDs with a single common descriptive name. This would be used 
when creating a group that contains more than a single UID as a recipient for a 
message. To clear all the recipients from a message, call the ClearMessageRecipients 
method. 

Parameters 

MID 

A string representing the message identifier of the message. 
Value 

A string representing the descriptive name for the recipient. 
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UID 

A string representing the UID of the recipient. 

SetMessageAttachmentAsFile 
5 f xe "SetMessageAttachmentAsFile")! xe 

'^ESDK:SetMessageAttachmentAsFile") 

function SetMessageAttachmentAsFile (MID: String; Name: String) : Boolean; 

The SetMessageAttachmentAsFile attaches a file to a message from a given 
path. This method will attach and compress a file to a message based upon the given 
10 path. 

For example, 

MyESDK.SetMessageAttachmentAsFile(MID,"C: .BAT") 

Attachments are automatically compressed as they are included with the message. To 
attach a message from data that is already in memory see 
15 SetMessageAttachmentAsStream or SetMessageAttachmentAsOleVariant. To 

extract a message, upon receipt, use the GetMessageAttachmentAsFile method. To 
clear all the attachments from a message, call the ClearMessageAttachments method. 

Parameters 

MID 

20 A string representing the message identifier of the message. 

Name 

A string representing the path and filename of the attachment. 

Return Values 

If the method succeeds, the return value is TRUE. 
25 If the method fails, the return value is FALSE. 
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SetMessageAttachmentAsStream 

(xe "SetMessageAttachmentAsStream") 

(xe "TESDK:SetMessageAttachmentAsStream"l 

procedure SetMessageAttachmentAsStream(MID: String; Name: String; Value: 
5 TMemoryStream); 

The SetMessageAttachmentAsStream attaches a file to a message from a 
stream. This method will attach and compress a file to a message based upon a 
stream. 
For example, 

10 MyESDK. SetMessageAttachmentAsStream(MID, "AUTOEXEC.BAT",MyStream) 

Attachments are automatically compressed as they are included with the message. To 

attach a message from a file instead of memory, see SetMessageAttachmentAsFile. 

To extract a message upon receipt, use the GetMessageAttachmentAsFile method. 

Streams are designed primarily for Borland development environments. For 
1 5 Microsoft and other development environments see 

SetMessageAttachmentAsOleVariant instead. To clear all the attachments from a 

message, call the ClearMessageAttachments method. 

Parameters 
MID 

20 A string representing the message identifier of the message. 

Name 

A string representing the path and filename of the attachment. 
Value 

A stream representing the attachment. 

25 

SetMessageAttachmentAsOleVariant 

{xe "SetMessageAttachmentAsOleVariant"} 

{xe "TESDKiSetMessageAttachmentAsOleVariant"! 

procedure SetMessageAttachmentAsOle Variant (MID: String; Name: String; Value: 
30 OleVariant); 
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The SetMessageAttachmentAsOleVariant attaches a file to a message from 
an olevariant. This method will attach and compress a file to a message based upon 
an olevariant. 
For example, 
5 MyESDK.SetMessageAttachmentAsO 
MyOleVariant) 

Attachments are automatically compressed as they are included with the message. To 

attach a message from a file instead of memory, see SetMessageAttachmentAsFile. 

To extract a message upon receipt, use the GetMessageAttachmentAsFile method. 
1 0 OleVariants are designed primarily for Microsoft development environments. For 

Borland development environments see SetMessageAttachmentAs Stream instead. 

To clear all the attachments from a message, call the ClearMessageAttachments 

method. 

Parameters 
15 MID 

A string representing the message identifier of the message. 
Name 

A string representing the path and filename of the attachment. 
Value 

20 An olevariant representing the attachment. 

GetMessageString 

(xe "GetMessageString»Hxe "TESDK:GetMessageString»l 
function GetMessageString(MID: String; Prop: Integer) : String; 
25 The GetMessageString method gets a property string from an in-memory 

message record. To retrieve a string from an in-memory message record, provide the 
MID of the message record and the property value of the string. 
For example, 

Identity=MyESDK. GetMessageString(MID, 103) 
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The property value 103 (T_MESSAGEJFROM) represents the sender's identity. For 
a complete listing of property values, see Message constants. To create extensible 
custom message properties, see How to Create a Custom Message Property. 
Parameters 
5 MID 

A string representing the message identification value. 
Prop 

An integer representing the property value of the string. 
Return Values 

10 If the method succeeds, the return value is the string value of the specified 

property. 

If the method fails, the return value is NULL. 



GetMessagelnteger # 
15 {xe "GetMessagelnteger"} {xe "TESDK:GetMessageInteger"} 

function GetMessageInteger(MID: String; Prop: Integer) : Integer; 

The GetMessagelnteger method gets a property integer from an in-memory 

message record. To retrieve an integer from an in-memory message record, provide 

the MID of the message record and the property value of the integer. For a listing 
20 property values, see Message constants. To create extensible custom message 

properties, see How to Create a Custom Message Property. 

Parameters 
MID 

A string representing the message identification value. 
25 Prop 

An integer representing the property value of the integer. 
Return Values 

If the method succeeds, the return value is the integer value of the specified 
property. 

30 If the method fails, the return value is 0. 
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GetMessageBoolean 

(xe "GetMessageBoolean»V{xe "TESPK:GetMessageBoolean»l 
function GetMessageBoolean(MID: String; Prop: Integer) : Boolean; 
5 The GetMessageBoolean method gets a property boolean from an in-memory 

message record. To retrieve a boolean from an in-memory message record, provide 
the MID of the message record and the property value of the boolean. For a listing 
property values, see Message constants. To create extensible custom message 
properties, see How to Create a Custom Message Property. 
10 Parameters 
MID 

A string representing the message identification value. 
Prop 

An integer representing the property value of the boolean. 
15 Return Values 

If the method succeeds, the return value is the boolean value of the specified 
property. 

If the method fails, the return value is FALSE. 

20 GetMessagePateTime 

(xe "GetMessagePateTime"Uxe "TESPK:GetMessagePateTime"l 
function GetMessageDateTime(MID: String; Prop: Integer): TDateTime; 

The GetMessageDateTime method gets a property datetime from an in- 
memory message record. To retrieve a datetime from an in-memory message record, 

25 provide the MID of the message record and the property value of the datetime. For a 

listing property values, see Message constants. To create extensible custom message 
properties, see How to Create a Custom Message Property. 
Parameters 
MID 

30 A string representing the message identification value. 
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Prop 

An integer representing the property value of the datetime. 
Return Values 

If the method succeeds, the return value is the datetime value of the specified 
5 property. 

If the method fails, the return value is 0. 

GetMessageStream 

Ixe "GetMessageStream»Xxe "TESDK:GetMessageStreaml 
10 function GetMessageStream(MID: String; Prop: Integer) : TMemory Stream; 

The GetMessageStream method gets a property stream from an in-memory 
message record. To retrieve a stream from an in-memory message record, provide 
the MID of the message record and the property value of the stream. For a listing 
property values, see Message constants. To create extensible custom message 
1 5 properties, see How to Create a Custom Message Property. 

Parameters 
MID 

A string representing the message identification value. 
Prop 

20 An integer representing the property value of the stream. 

Return Values 

If the method succeeds, the return value is the stream value of the specified 
property. 

If the method fails, the return value is NIL. 

25 

GetMessageOleVariant 

{xe "GetMessageQleVariant"Uxe "TESDKzGetMessageOleVariant"! 

function GetMessage01eVariant(MID: String; Prop: Integer): Ole Variant; 

The GetMessageOleVariant method gets a property olevariant from an in- 
30 memory message record. To retrieve an olevariant from an in-memory message 
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record, provide the MID of the message record and the property value of the 
olevariant. For a listing property values, see Message constants. To create extensible 
custom message properties, see How to Create a Custom Message Property. 
Parameters 
5 MID 

A string representing the message identification value. 

Prop 

An integer representing the property value of the olevariant. 
Return Values 

10 If the method succeeds, the return value is the olevariant value of the 

specified property. 

If the method fails, the return value is NIL. 



GetMessageAttachmentName 
15 {xe "GetMessageAttachmentName"} 

(xe "TESDK:GetMessageAttachmentName»> 

function GetMessageAttachmentName(MID: String; Index: Integer): String; 

The GetMessageAttachmentName method returns the name associated with a 
given in-memory message attachment based upon the message attachment index. To 
20 determine the total count of attachments related to a message in memory, call the 

GetMessageAttachmentCount method. Indexes are relative to zero in memory. To 
walk the entire attachment list in memory, start at zero and go to 
GetMessageAttachmentCount minus one. 
Parameters 
25 MID 

A string representing the message identification value. 
Index 

An integer representing the in-memory message index. 
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Return Values 

If the method succeeds, the return value is a string representing the name of 
the attachment. 

If the method fails, the return value is NULL. 

5 

GetMessageAttachmentCount 

{xe "GetMessageAttachmentCount"! 

(xe "TESDK:GetMessageAttachmentCount»l 

function GetMessageAttachmentCount(MID: String) : Integer 
10 ~~ The GelMessageAttachmentCount method returns the total number of in- 

memory message attachments associated with the specified in-memory message. To 

extract the message attachment names associated with any particular index, see 

GetMessage AttachmentName . 

Parameters 
15 MID 

A string representing the message identification value. 

Return Values 

If the method succeeds, the return value is an integer message attachment 

count. 

20 If the method fails, the return value is 0. 

GetMessageAttachmentAsFile 
{xe "GetMessageAttachmentAsFile"} 
(xe "TESDK:GetMessageAttachmentAsFile"l 
25 function GetMessage AttachmentAsFile(MID: String; Index: Integer; Name: String) 

Boolean; 

The GetMessageAttachmentAsFile method saves an in-memory message 
attachment to a file. To determine the total count of attachments in memory, call the 
GetMessageAttachmentCoimt method. Message attachment indexes are relative to 
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zero in memory. To walk the entire message attachment listing in memory, start at 

zero and go to GetMessageAttachmentCount minus one. 

Parameters 

MID 

5 A string representing the message identification value. 

Index 

An integer representing the in-memory message index. 
Name 

A string representing the path and filename of the saved attachment. 
10 Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 



GetMessageAttachmentAsStream 
15 {xe "GetMessageAttachmentAsStream"! 

{xe *TESDK:GetMessageAttachmentAsStream"l 

function GetMessageAttachmentAsStream(MID: String; Index: Integer) : 
TMemoryStream; 

The GetMessageAttachmentAsStream method gets a stream from an in- 
20 memory message attachment. To determine the total count of attachments in 

memory, call the GetMessageAttachmentCount method. Message attachment 
indexes are relative to zero in memory. To walk the entire message attachment 
listing in memory, must start at zero and go to GetMessageAttachmentCount minus 
one. 

25 Parameters 

MID 

A string representing the message identification value. 
Index 

An integer representing the in-memory message index. 

30 
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Return Values 

If the method succeeds, the return value is a stream. 
If the method fails, the return value is NIL. 



5 GetMessageAttachmentAsOleVariant 

{xe "GetMessageAttachmentAsOleVariant"! 
{xe <4 TESDK:GetMessageAttachmentAsQleVariant"t 

function GetMessageAttachmentAs01eVariant(MID: String; Index: Integer) : 
OleVariant; 

10 The GetMessageAttachmentAsOleVariant method gets an olevariant from an 

in-memory message attachment. To determine the total count of attachments in 
memory, call the GetMessageAttachmentCount method. Message attachment 
indexes are relative to zero in memory. To walk the entire message attachment 
listing in memory, start at zejo and go to GetMessageAttachmentCount minus one. 

15 Parameters 
MID 

A string representing the message identification value. 
Index 

An integer representing the in-memory message index. 
20 Return Values 

If the method succeeds, the return value is an olevariant. 
If the method fails, the return value is NIL. 

GetMessageBodyAsText 
25 Ixe "GetMessageBodvAsText»Hxe "TESDK:GetMessageBodvAsText»> 

function GetMessageBodyAsText(MID: String) : String; 

The GetMessageBodyAsText method gets the body of a message from an in- 
memory message record. The body is converted from an RTF format to plain text as 
it is extracted into a string. 
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For example, 

Text=MyESDK.GetMessageBodyAsText(MID) 

To extract the body of a message in Rich Text Format, see GetMessageBodyAsRTF 
instead. 
5 Parameters 

MID 

A string representing the message identification value. 
Return Values 

If the method succeeds, the return value is a string representing the body of a 
10 message. 

If the method fails, the return value is NULL. 

GetMessageBodyAsRTF 

(xe "GetMessageBodvAsRTF»Uxe "TESDK: GetMessageBod vAsRTF M l 
15 function GetMessageBodyAsRTF(MID: String): String; 

The GetMessageBodyAsRTF method gets the body of a message from an in- 
memory message record. The body is formatted in Rich Text Format as it is 
extracted into a string. 
For example, 

20 RTF=MyESDK.GetMessageBodyAsRTF(MID) 

To extract the body of a message in plain text, see GetMessageBodyAsText instead. 
Parameters 
MID 

A string representing the message identification value. 
25 Return Values 

If the method succeeds, the return value is a string representing the body of a 
message. 

If the method fails, the return value is NULL. 
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GetMessageRecipientCount 

{xe "GetMessageRecipientCount") { "TESDK:GetMessapeRecipientCoiint»l 

function GetMessageRecipientCount(MID: String) : Integer; 

The GetMessageRecipientCount method returns the total number of in- 
5 memory recipients associated with the specified in-memory message. To extract the 

message recipient names associated with any particular index, see 
GetMessageRecipientName. 
Parameters 

MID 

10 A string representing the message identification value. 

Return Values 

If the method succeeds, the return value is an integer message recipient 

count. 

If the method fails, the return value is 0. 

15 

GetMessageRecipientName 

{xe "GetMessageRecipientName"} {xe "TESDK:GetMessageRecipientName"} 

function GetMessageRecipientName(MID: String; Index: Integer): String; 

The GetMessageRecipientName method returns the name associated with a 
20 given in-memory message recipient based upon the message recipient index. To 

determine the total count of recipients related to a message in memory, call the 
GetMessageRecipientCount method. Indexes are relative to zero in memory. To 
walk the entire recipient list in memory, start at zero and go to 
GetMessageRecipientCount minus one. 
25 Parameters 
MID 

A string representing the message identification value. 
Index 

An integer representing the in-memory recipient index. 
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Return Values 

If the method succeeds, the return value is a string representing the name of 
the recipient. 

5 If the method fails, the return value is NULL. 

GetMessageRecipientUserCount 

{xe "GetMessageRecipientUserCount"! 

(xe "TESDK:GetMessageRecipientUserCount»l 

10 function GetMessageRecipientUserCount(MID: String; Index: Integer) : Integer; 

The GetMessageRecipientUserCount method returns the total number of in- 
memory user identifications associated with the specified in-memory message 
recipient To extract the message recipient user identification associated with any 
particular index, see GetMessageRecipientUser. 
15 Parameters 
MID 

A string representing the message identification value. 
Index 

An integer representing the in-memory recipient user identification index. 
20 Return Values 

If the method succeeds, the return value is an integer message recipient user 
identification count. 

If the method fails, the return value is 0. 

25 GetMessageRecipientUser 

(xe "GetMessageRecipientUser"! (xe "TESDK:GetMessageRicipientUser"l 
function GetMessageRecipientUser(MID: String; Index, IndexU; Integer) String; 

The GetMessageRecipientUser method returns the user identification 
associated with a given in-memory message recipient based upon the message 

30 recipient user identification index. To determine the total count of recipient user 
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identifications related to a message recipient in memory, call the 
GetMessageRecipientUserCount method. Indexes are relative to zero in memory. To 
walk the entire recipient list in memory, start at zero and go to 
GetMessageRecipientUserCount minus one. 
5 Parameters 
MID 

A string representing the message identification value. 
Index 

An integer representing the in-memory recipient index. 
10 ^ IndexU 

An integer representing the in-memory recipient user identification index. 
Return Values 

If the method succeeds, the return value is a string representing the user 
identification. 

15 If the method fails, the return value is NULL. 



GetMessageCount 

(xe "GetMessageCount»l(xe "TESDKtGetMessageCount"! 
function GetMessageCount: Integer; 

20 The GetMessageCount method returns the total number of in-memory 

messages that have been received within the real-time client. The real-time client 
keeps track of messages in memory. Messages are automatically cleared from 
memory if MessageAutoClear is TRUE once the message is received and after the 
OnMessage event or the message is sent using SetMessage. To manually clear in- 

25 memory message records, see the ClearMessage and ClearMessageAll methods. 

Return Values 

If the method succeeds, the return value is an integer message count. 
If the method fails, the return value is 0. 



30 
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GetMessageMTD 

(xe "GetMessageMID»Hxe "TESDKtGetMessageMID"} 
function GetMessageMID(Index: Integer) : String; 

The GetMessageMID method returns the MID associated with a given in- 
5 memory message based upon the in-memory message index. To determine the total 

count of messages in memory, call the GetMessageCount method. Message indexes 
are relative to zero in memory. To walk the entire status listing in memory, at zero 
and go to GetMessageCount minus one. 
Parameters 
10 Index 

An integer representing the in-memory message index. 
Return Values 

If the method succeeds, the return value is the MID string. 

If the method fails, the return value is NULL. 

15 

GetMessageRequestAll 

{xe "GetMessageRequestAll"Hxe «TESDK;GetMessageRequestAll»l 

function GetMessageRequestAll: Boolean; 

The GetMessageRequestAll method requests all pending messages for the 
20 user from the real-time server. To obtain any offline or pending messages for the 

user from the real-time server use this method. The message is received in the 
OnMessage event. 
Return Values 

If the method succeeds, the return value is TRUE. 
25 If the method fails, the return value is FALSE. 
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ExistMessageProp 

Ixe "ExistMessageProp»Hxe "TESDK:ExistMessageProp"l 
function ExistMessageProp(MID: String; Prop: Integer) : Boolean; 

The ExistMessageProp method checks for the existence of a property within 
an in-memory message record. This method can be used to check for the existence of 
a property in an in-memory message record. The method can be used for both 
common message properties and custom message properties. For a listing property 
values, see Message constants. To create extensible custom message properties, see 
How to Create a Custom Message Property. 
Parameters 
MID 

A string representing the message identification value. 
Prop 

An integer representing the property value. 
Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 

ExistMessage 

20 Ixe "ExistMessaGe»Hxe «TESDK;ExistMessage»> 

function ExistMessage(MIE): String) : Boolean; 

The ExistMessage method checks for the existence of a given in-memory 
message record. 
Parameters 
25 MID 

A string representing the message identification value. 
Return Values 

If the method succeeds, the return value is TRUE. 
If the method fails, the return value is FALSE. 

30 
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ClearMessage 

(xe "ClearMessape»l(xe "TESDK:ClearMessage»l 
procedure ClearMessage(MID: String); 

The ClearMessage method clears an in-memory message. 
5 Parameters 

MID 

A string representing the message identification value. 



ClearMessageAll 
10 {xe "ClearMessageAlPHxe "TESDK:ClearMessageAll"> 

procedure ClearMessageAll; 

The ClearMessageAll method clears all in-memory messages. 

ClearMessageRecipients 
15 (xe "ClearMessageRecipients»Uxe "TESDK:ClearMessageRecipients»l 

procedure ClearMessageRecipients(MID: String); 

The ClearMessageRecipients method clears the recipients from an in- 
memory message. This method can be used to clear the recipients from any in- 
memory message. 
20 Parameters 
MID 

A string representing the message identification value. 



ClearMessageAttachment 
25 {xe "ClearMessageAttachments"! (xe "TESDK:ClearMessageAttachments»l 

procedure ClearMessageAttachments(MID: String); 

The ClearMessageRecipients method clears the attachments from an in- 
memory message. This method can be used to clear the attachments and free the 
associated memory from any in-memory message. 
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Parameters 

MID 

A string representing the message identification value. 

5 Connect 

{xe "Connect»Hxe "TESDKrConnect"} 
function Connect '.Boolean; 

The Connect method attempts to connect to a real-time server. In order to 

connect to a real-time server, first provide the IP address and Port information of the 
10 real-time server along with the client's Identity and personal user identification UID. 

The Connect method returns TRUE if a socket connection was established. The 

Connect method returning TRUE does not constitute that the connection is approved 

by the real-time server. The connection is not approved until an OnClientConnected 

event is received. 
15 For example, 

MyESDK.IP="127.0.0.r 

MyESDK. Port = 35000 

MyESDKJdentity = "John Smith" 

MyESDKXTID MyESDKCreatelD 
20 MyESDK.Connect 

For more details on connecting to a real-time server, see How To Connect to a 

Server. 

Return Values 

If the method succeeds, the return value is TRUE. 
25 If the method fails, the return value is FALSE. 
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Disconnect 

(xe "Disconnect"}(xe "TESDK:Disconnect»l 
procedure Disconnect; 

The Disconnect method attempts to disconnect from a real-time server. The 
5 Disconnect method issues a graceful disconnection from a real-time server. The 

Disconnect method automatically sets the user status to offline before the user is 
disconnected. 
For example, 
MyESDK.Disconnect 

10 

EVENTS 
OnClientError 

ixe "OnClientError»Xxe "TESDK:OnClientError»l 

property OnClientError: TOnClientError; 
1 5 The OnClientError event is fired if the real-time client experiences an error in 

connection or communications. Typically this event is fired in the event of a socket 
communications problem. This event is optional. 
Parameters 
Error 

20 A string representing the client error message. 

OnClientConnectProgress 

{xe "OnClientConnectProgress"} "TESDK:OnClientConnectProgress"l 

property OnClientConnectProgress: TOnClientConnectProgress; 
25 The OnClientConnectProgress event provides information concerning the 

connection progress. This event is optional and can be used to inform users of the 
status of the connection progress. 
Parameters 
Msg 

30 A string representing the client connection progress message. 
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QnClientConnected 

(xe "OnClientConnected»l(Xe "TESDK;OnClientConnected*l 

property OnClientConnected: TOnClientConnected; 

5 The OnClientConnected event is fired when the connection is fully 

established and communication can proceed. This event should be handled by the 
real-time client application and all initial status and initial message delivery 
communications should happen in this event. During this event it is typical to set 
personal status, make requests for other user's status and request any messages that 

10 are offline or pending. The following examples demonstrate the appropriate 

methods. 
For example, 

MyESDK.SetStatusInteger(l 01,1) 
MyESDK.SetStatusString(l 00 "Online 
1 5 MyESDK.SetStatus 

The above example sets the status message and icon to online. See SetStatus for 
more information. 
For example, 

MyESDK.GetStatusRequestAll 
20 The above example requests an entire listing of users from the real-time server. See 

GetStatusRequestAll for more information. 
For example, 

MyESDK. GetMessageRequestAU 

The above example requests all offline and stored messages from the real-time 
25 server. See GetMessageRequestAU for more information. 
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OnClientDisconnected 

Ixe "OnClientDisconnected»l{xe '^ESDKtOnClientDisconnected" 

property OnClientDisconnected: TOnClientDisconnected; 

The OnClientDisconnected event is fired when the client disconnects from 
5 the real-time server. This event is optional and can be used to be informed of a 

disconnection. 

OnClientCertificateKeys 

Ixe "OnClientCertificateKevs"Hxe "TESDK:OnClientCertificateKevs»l 

10 property OnClientCertificateKeys: TOnClientCertificateKeys; 

The OnClientCertificateKeys event is fired when the real-time server is using 
a security policy that requires public key encryption keys in order to communicate 
with the real-time server. This event is optional and can be handled by the real-time 
client application if the client maintains the public and private keys. The CreateKeys 

1 5 parameter should be set to TRUE if the keys will be created automatically and 

FALSE if the keys will be provided manually. Because keys can take some time to 
be generated, it is beneficial to retain the keys in the client application and pass them 
back through the use of this event. For more details on this topic see the GetSecurity 
and GetCertificateKeys methods. 

20 Parameters 

CreateKeys 

A boolean indicating whether the certificate keys should be created 
automatically or manually. 
PublicKey 

25 A string representing the public key of an encryption key pair. 

PrivateKey 

A string representing the private key of an encryption key pair. 
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OnClientUID 

(xe "OnClientUID»l(xe "TESDK:OnClientUID»l 

property OnClientUID: TOnClientUID; 

The OnClientUID event is fired when the real-time server is providing the 
5 correct user identification based upon the Account and Password provided during the 

connection sequence. This event should be handled by the real-time client 
application in the case of password authentication. 
Parameters 
UID 

10 A string representing the user identification of an authenticated user. 

OnClientLogon 

(xe u OnClientLogon w H"TESDK:OnClientLogon 9> l 

property OnClientLogon: TQnClientLogon; 
1 5 The OnClientLogon event is fired in the event the real-time server needs an 

Account and Password to proceed with the connection. This event should be handled 
by the real-time client application if using password authentication. 
Parameters 

Account 

20 A string representing the account name for logon. 

Password 

A string representing the password for logon. 

OnServerMessage 
25 (xe "OnServerMessage"} (xe "TESDK: OnServerMessage"! 

property OnServerMessage: TOnServerMessage; 

The OnServerMessage event is fired when the real-time server needs to 

report a condition, message or error the real-time client. This event should be 

handled by the real-time client application and the message should be displayed to 
30 the real-time client user. 
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Parameters 

Msg 

A string representing the server message. 

5 OnStatus 

jxe "OnStatus»l(xe "TESDK:OnStatus»l 
property OnStatus: TOnStatus; 

The OnStatus event is fired when an incoming status is received. Status 
events can be caused by both manual requests, and automatic status requests. 

1 0 GetStatusRequestAll and GetStatusRequestQuery will cause manually status events 

based upon the requested status information. One status event is generated for each 
user that matches the requested query. The client will be automatically notified with 
an OnStatus event as a user's status changes provided, either use full status mode or 
by individually requesting status tracking for specific UBDs by calling the 

15 GetStatusRequest method. To change from full state mode to partial status mode, see 

the SetStatusMode method. 
Parameters 
UID 

A string representing the user identification value. 

20 

OnMessage 

{xe "OnMessage"Hxe "TESDK:OnMessage»l 
property OnMessage: TOnMessage; 

The OnMessage event is fired when an incoming message is received. 

25 Message events can occur automatically while the client is connected to a real-time 

server. A message event can also occur manually through the use of the 
GetMessageRequestAll event. The optional delivered parameter allows the client to 
control the state of the delivery of the message. This information is logged by the 
Audit and Reporting add-ons for tracking purposes and can be used for a variety of 

30 purposes related to message delivery confirmation. The default value of 2 
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(T_DELIVERED) instructs the real-time server than the message was delivered. For 

more information on this subject, see How To: Receive a message. 

Parameters 

MID 

5 A string representing the message identification value. 

Delivered 

A string representing the delivery value. 
OnCommand 

10 {xe "OnCommand"Hxe "TESDK:OnCommand»l 

property OnCommand: TOnCommand; 

The OnCommand event is fired when an incoming real-time command is 
received. 
Parameters 
15 RID 

A string representing the command identification value. 

How To Connect to a Server 

The following describes the basics of connecting to a real-time server. The 
20 client must supply the IP address and Port information of the real-time server along 

with the client's Identity and personal user identification (UID) and then call the 
Connect method. 
For example, 

MyESDKJP = "127.0.0.1" 
25 MyESDK. Port = 35000 

MyESDKJdentity = "John Smith" 
MyESDK.UID MyESDK.CreateID 
MyESDK.Connect 
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UID 

A UID uniquely identifies the user to the real-time server. The user can either 
maintain the UID information in the client application or the can enable 
authentication on the real-time server and have the real-time server maintain the UID 

5 information. If the user maintains the UID within the application, the client needs to 

call CreatelD at least once to generate a UID value and then retain that value in the 
client application. If the real-time server is maintaining the UID, the client must 
enable user authentication in the real-time server console and provide an Account 
and Password when the client connects. Once the account and password are verified 

10 by the real-time server, the client will be provided the user's UID through the 

OnClientUID event. 

Connection Related Events 

OnClientConnectProgress 
15 The OnClientConnectProgress event provides information concerning the 

connection progress. This event is optional and can be used to inform users of the 
status of the connection progress. 

OnClientConnected 

20 The OnClientConnected event is fired when the connection is fully 

established and communication can proceed. This event should be handled by the 
real-time client application and all initial status and initial message delivery 
communications should happen in this event. 

25 OnClientDisconnected 

The OnClientDisconnected event is fired when the client disconnects from 
the real-time server. This event is optional and can be used to inform users of a 
disconnection. 
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OnClientLogon 

The OnClientLogon event is fired in the event the real-time server needs an 
Account and Password to proceed with the connection. This event should be handled 
by the real-time client application if the user intends to use password authentication. 

OnClientUID 

The OnClientUID event is fired when the real-time server is providing the 
correct user identification based upon the Account and Password provided during the 
connection sequence. This event should be handled by the real-time client 
application if the user intends to use password authentication. 

OnClientError 

The OnClientError event is fired if the real-time client experiences an error in 
connection or communications. Typically this event is fired in the event of a socket 
15 communications problem. This event is optional. 

OnServerMessage 

The OnServerMessage event is fired when the real-time server needs to 
report a condition, message or error the real-time client. This event should be 
20 handled by the real-time client application and the message should be displayed to 

the real-time client user. 



5 



10 



OnClientCertificateKeys 

The OnClientCertificateKeys event is fired when the real-time server is using 
25 a security policy that requires public key encryption keys in order to communicate 

with the real-time server. This event is optional and can be handled by the real-time 
client application if the client maintains the public and private keys. 
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How to Send Status 

The following describes the basics of sending personal status to the real-time 

server. 

For example, 
5 MyESDK.SetStatusInteger(10 1 . 1) 

MyESDK.SetStatusString(100,"Online") 
MyESDK.SetStatus 

In the above example the SetStatusInteger method sets the property 101 
(T_STATUSJSTI) to the value 1 (STAJ3N). This sets the status icon to online. The 

10 SetStatusString method sets the property 100 (T_STATUS_MSG) to the value 

"Online". This sets the message that is displayed for status. 

The SetStatus method can be called at any time the client needs to update or 
change its personal status with the real-time server. After an initial connection is 
established it is normal to announce personal status to the real-time server during the 

15 OnClientConnected event. For a listing property values, see Status constants. 



How to Send a Message 

To send a message within the real-time client, construct a complete message 
20 with various details. Those details include setting the recipients, the sender, the 

subject and the body of a message and then calling SetMessage to send the message. 
For a listing property values, see Message constants. 
For example, 

MyESDK.SetMessageRecipient(MID, 9, John Smith", UID) 
25 MyESDK.SetMessageString(MID,103,''Myself , ) 

MyESDK.SetMessageString(MID,109,UID); 

MyESDK.SetMessageDateTime(MID, 106, Now) 

MyESDK.SetMessageString(MlD, 105,"My Subject") 

MyESDK.SetMessageBodyAsRTF(MID, RTF) 
30 MyESDK.SetMessage(MID) 
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Recipients 

To add recipients to the message, see the SetMessageRecipient method, 
above. As many recipients as desired for a message may be designated by calling 
5 once for each given recipient. 

For example, 

MyESDK. SetMessageRecipient(MTO,"John Smith", UID) 

In the above example, the UID represents the recipient John Smith's UID value. By 
calling SetMessageRecipient with the same name and different UIDs the client will 
1 0 create a single visible object within the recipient list that is sent to multiple UIDs. 

Sender 

To set the sender's information, use 103 (TJVffiSSAGEJFROM) and 109 
(T_MES S AGE_FROM_UID) related message constants. For more information, see 
15 Message constants. 

For example, 

MyESDK.SetMessageString(MED, 'Myself ) 
MyESDK.SetMessageString(Ml D, 109, UI D); 

20 Sent 

To set the sent date and time, use 106 (T_MESSAGE_SENT) and the 
datetime that the message was sent. 
For example, 

MyESDK. SetMessageDateTime(MID, 106, Now) 
25 Under Microsoft development environments use DateTime.Now.ToOADate to get 

the correctly formatted date and time. 
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Subject 

To set the subject use 105 (T_MESSAGE_SUBJECT). 
For example, 

MyESDK. SetMessageString(MID, 1 05,"My Subject") 

5 

Body 

The body of a message is a rich text formatted content. To add body content 
to the message, use the SetMessageBodyAsRTF or the SetMessageBodyAsText 
methods. 
10 For example, 

MyESDK.SetMessageBodyAsRTF(MI D, RTF) 

Sending the message 

To send the message once it is constructed, call the SetMessage method. 
15 For example, 

MyESDK.SetMessage(MID) 

Attachments 

Attachments are optional and can be included with a message using the 
20 SetMessageAttachmentAsFile, SetMessageAttachmentAsStream and 

SetMessageAttachmentAsOleVariant methods. 

Custom properties 

Custom message properties allow the user to include unique information with 
25 any message sent. For more information on custom message properties, see How To 

Create a Custom Message Property. 

How to Receive a Message 

To receive messages, handle the OnMessage event within the real-time client. 
30 The OnMessage event is fired whenever a message is received. Message events can 
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occur automatically while connected to a real-time server. A message event can also 
occur manually through the use of the GetMessageRequestAll event. 
For example, 

Identity = MyESDK.GetMessageString(MID, 103) 
5 RichTextRtf = MyESDK.GetMessageBodyAsRTF(M ID) 

In the above example, the identity of the sender 103 (T_MES S AGE_FROM) is 
extracted from the incoming message and placed into the variable Identity. The MID 
is a parameter to the OnMessage event. The body of the message is then extracted 
from the message using the GetMessageBodyAsRTF method and placed directly into 

10 a RichEdit control visually residing on the form. 

Within the OnMessage event, the optional delivered parameter allows the 
client to control the state of the delivery of the message. This information is logged 
by the Audit and Reporting add-ons for tracking purposes and can be used for a 
variety of purposes related to message delivery confirmation. The default value of 2 

1 5 (T_DELIVERED) instructs the real-time server than the message was delivered. 

Other delivery parameters include: 
T_UNDEL1 VERED= 1 

The message is undelivered. The message will remain on the server and will be 
resent on the next message request; 

20 

T_DEL1VERED=2 

The message is delivered. The delivery is logged and the message is purged from the 
real-time server. 

25 T_PERFORMED=3 

Not used for messages. 

TJDENEED=4 

Not used for messages. 

30 
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T_EXPIRED=5 

The message expired instead of being delivered. 

How to Receive Status 
5 To receive status, handle the OnStatus event within the real-time client. The 

OnStatus event is fired when an incoming status is received. 
For example, 

Identity = MyESDK.GetStatusS1iing(UID, 103) 
State = MyESDK.GetStatusInteger(UID, 101) 

10 In the above example, the identity 103 (T_STATUS_IDENTITY) is extracted from 

the incoming status and placed into the variable Identity. The state 101 
(T_STATUS_STI) is then extracted from the incoming status and placed into the 
variable State, subsequently use this status information to populate a buddy list 
contained within a ListView or TreeView visual component. 

1 5 Status events can be caused by both manual requests, and automatic status 

requests. GetStatusRequestAll and GetStatusRequestQuery will cause manually 
status events based upon the requested status information. One status event is 
generated for each user that matches the requested query. The client will be 
automatically notified with an OnStatus event as a user's status changes provided 

20 either use full status mode or by individually requesting status tracking for specific 

UIDs by calling the GetStatusRequest method. To change from full state mode to 
partial status mode, see the SetStatusMode method. 

How to Create a Custom Status Property 

25 The status properties within the ESDK are completely extensible. Using the 

SetStatusString, SetStatusInteger, SetStatusDateTime and SetStatusBoolean methods 
custom status properties can be applied to any status. 
For example, 

MyESDK.SetStatusInteger(l 0000,5) 
30 MyESDK.SetStatusString(l 0001 /'Data") 
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MyESDK.SetStatus 

In the above example the status property 10000 is assigned the integer value of 5 and 
the status property 10001 is assigned the string value "Data". Starting any custom 
status properties at 10000 is recommended. It is important to remember and track the 
5 status property values within the application and the corresponding data type 

associated with the property. The information can be extracted using the respective 
GetStatusInteger and GetStatusString related methods. 

How to Create a Custom Message Property 
10 ^ The message properties within the ESDK are completely extensible. Using 

the SetMessageString, SetMessagelnteger, SetMessageBoolean, 
SetMessageDateTime and SetMessageStream methods, custom message properties 
can be applied to any message. 
For example^ 

15 MyESDK.SetMessageInteger(MID, 10000,25) 

MyESDK 10001 /'Hello' 9 ) 
MyESDK.SetMessage(MID) 

In the above example the message property 10000 is assigned the integer value of 25 
and the message property 10001 is assigned the string value "Hello". Starting any 
20 custom message properties at 10000 is recommended. It is important to remember 

and track the message property values within the application and the corresponding 
data type associated with the property. The information can be extracted using the 
respective GetMessagelnteger and GetMessageString related methods. 

25 Constants 

Status constants 

The following default status constants are predefined within the real-time 
client and server. To define custom status properties, see How To Create a Custom 
Status Property. To set any of the following status properties, see the SetStatusString, 
30 SetStatusInteger and SetStatusDateTime methods. 
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Type 


Value 


Data Tvpe 


Description 




T_STATUS_MSG 


100 


String 


Status ("online", 

"offline \ "away from desk , 


5 








etc) 




T_STATUS_STI 


101 


Integer 


State (l=online 2=offline 3=dnd, 
see below) 




T_STATUS_IDENTITY_ 


103 


Identity 


(ex: "John Smith", the displayed 
name) 


10 


T_STATUS_LOGON 


104 


String 


Network logon name (optional) 




T_STATUS_MACH 


105 


String 


Machine computer name 
(optional) 




T_STATUS_PHONE 


106 


String 


Phone number {optional) 




T_STATUS_TJME 


110 


DateTime 


Last status change date and time 


15 








(optional) 




T_STATUS_UID 


113 


String 


UID 




T_STATUS_GROUP 


115 


String 


Member of group (optional) 




TST ATU S_EMAIL 


121 


String 


Email address (optional) 




T_STATUS_IP 


122 


String 


TCP/IP address (optional) 


20 


T_STATUS_VERSION 


123 


String 


Version 



25 



State Values 

The following default state values are used in conjunction with the state 
integer property: 
101 (T_STATUS_STI). 



STA_NONE=0; 
None. 
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STA_ON=l; 
The user is online. 

STA_OFF=2; 
5 The user is offline. 

STAJDND=3; 

The user is in the do not disturb state. 

10 STA_AWAY=4 

The user is in the away state. 

Message Constants 

The following default message constants are predefined within the real-time 
1 5 client and server. To define custom message properties, see How To Create a 

Custom Message Property. To set any of the following message properties, see the 
SetMessageString, SetMessagelnteger and other related methods. 



Type 




Value 


Data Tvoe 


Description 


T_MESSAGE_ 


REPLY 


100 


Boolean 


Reply is allowed 


T_MESSAGE_ 


MID 


101 


String 


MID 


T_MESSAGE_ 


FROM 


103 


String 


Identity of sender 










(displayed name) 


T_MESSAGE. 


.SUBJECT 


105 


String 


Subject 


TJMESSAGE. 


SENT 


106 


DateTime 


Sent message 










date and time 


T_MESSAGE 


BUTTON 


107 


String 


Instant reply 










button caption 


T_MESSAGE 


_FROM_UID 


109 


String 


UTD of sender 
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T_MESSAGE_PRIORITY_HIDE 


119 


Boolean 


Always hide the 








message 


T_MESSAGE_PRIORITY_SHOW 


124 


Boolean 


Always show the 








message 


T_MESSAGEJPRIORITY DEFAULT 


125 


Boolean 


Always use 








preference 


T_MESSAGE_POSITJON 


126 


Boolean 


Use custom 








position 


TJS4ESSAGEJ>OSITIONJJL 


127 


Integer 


Upper left 


TJMESSAGEJPOSITIONJJR 


128 


Integer 


Upper right 


T_MESSAGE_POSITION_LL 


129 


Integer 


Lower left 


TJVIESSAGEJ>OSITIONJLR 


130 


Integer 


Lower right 


T_MESSAGE_POSITION_CASCADE 


131 


Boolean 


Always cascade 








the message 


T__MESSAGE_SIZE 


132 


Boolean 


Use custom size 


T_MESSAGE_SIZE_WIDTH 


133 


Integer 


Width 


T MESSAGESIZEJHEIGHT 


134 


Integer 


Height 



From the foregoing, it may be seen that the SDK of the present invention 
20 provides a set of tools for creating comprehensive real-time communication 

applications, such as instant messaging, chat and presence programs for business and 
other applications. The SDK is designed to operate in most newer development 
environments, such as those created by Borland and Microsoft. 

The SDK of the present invention embeds instant messaging and presence 
25 within existing business software. The SDK also allows the customization of instant 

messaging (IM) solutions for business applications. The SDK also allows branded 
OEM products to utilize instant messaging of the present invention. The SDK of the 
present invention also allows real-time applications to stream information through 
the real-time engine. The SDK also provides web-based instant messaging solutions. 
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The real-time platform provides advanced features, such as comprehensive 
security and encryption, off-line message delivery, file attachments, auditing 
features, and archiving and the ability to extend any portion of the real-time 
architecture to transport custom information. The real-time platform has the ability to 
5 automatically interconnect multiple real-time servers together. The transport handles 

all the routing automatically, as disclosed herein, so interfacing software code to 
presence and instant messaging is less difficult to build and maintain, but is versatile 
enough to accomplish any real-time requirement needs. 

The SDK, also referred to as ESDK, is completely extensible so that users 
10 can add information to status and presence or messages, as well as build entirely 

unique solutions, as required. Software programmers can leverage the off-line 
delivery capability of messages to include solution specific content. 

The real-time transport technology, as disclosed herein, securely and 
efficiently connects multiple offices together and may route securely over virtually 
15 any TCP connection. The software programmer does not need to worry about how to 

communicate in real-time to a variety of people that are dispersed geographically, 
since this is handled automatically with the ESDK, as disclosed herein. Users are 
tracked throughout the real-time system based upon ESDK server. Real-time channel 
communications are automatically routed to the destination clients over any routed 
20 connection to constantly, persisted connections. All status information is 

automatically propagated throughout the real-time system over pipes and persistent 
client connections. A centralized management console allows the user to manage the 
connections between servers, security, routing, users and multiple groups. 
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WHAT IS CLAIMED IS: 

1. A software development kit for enabling a developer to provide real-time 
communications capabilities to an application program, which comprises: 

means for establishing a connection to a real-time server; 
5 means for sending a message; and, 

means for receiving a message. 

2. The software development kit as claimed in claim 1, including: 

means for disconnecting from a. real-time server. 

10 

3. The software development kit as claimed in claim 1, including: 

means for creating a communications channel through a real-time platform 
associated with said real-time server. 



15 4. The software development kit as claimed in claim 3, including: 

means for joining a third party user to said communications channel. 

5. The software development kit as claimed in claim 3, including: 

means for deleting a third party user from said communications channel. 

20 

6. The software development kit as claimed in claim 3, including: 

means for invoking said communications channel. 

7. The software development kit as claimed in claim 3, including: 
25 means for destroying said communications channel. 

8. The software development kit as claimed in claim 1, including: 

means for announcing status to said real-time server. 
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9. The software development kit as claimed in claim 1, including: 

means for requesting third party user status from said real-time server. 



88 



WO 2004/012050 



T/US2003/023331 



CLIENT 




CLIENT 




CLIENT 










SERVER 




SERVER 




SERVER 






















CLIENT 


CLIENT 


CLIENT 



FIG. 1 



ENTERPRISE 

INSTANT 
MESSAGING 


EXTRANET WEB 
CONFERENCING 


VOICE AND VIDEO 
CONFERENCING 


ESDK 


ECONFERENCING SDK 


COMPONENT ARCHITECTURE 


SECURITY AND 
ENCRYPTION 


DIRECTORY 
INTEGRATION 


CENTRALIZED 
MANAGEMENT 


CHANNELS 


PIPES 


PRESENCE 


REAL-TIME ROUTING ENGINE 



FIG. 2 



i/i 



